Начало работы с MCP

from mcp.server.fastmcp import FastMCP

# Инициализация сервера
mcp = FastMCP("Мой первый сервер")

# Инструмент: функция, которую AI может вызвать
@mcp.tool()
def calculate(operation: str, a: float, b: float) -> float:
    """
    Выполняет математическую операцию.

    Args:
        operation: Операция (add, subtract, multiply, divide)
        a: Первое число
        b: Второе число

    Returns:
        Результат вычисления
    """
    match operation:
        case "add":
            return a + b
        case "subtract":
            return a - b
        case "multiply":
            return a * b
        case "divide":
            if b == 0:
                raise ValueError("Деление на ноль")
            return a / b
        case _:
            raise ValueError(f"Неизвестная операция: {operation}")

# Ресурс: данные, которые AI может прочитать
@mcp.resource("info://server")
def get_server_info() -> str:
    """Информация о сервере"""
    return """
    Сервер: Мой первый MCP сервер
    Версия: 1.0.0
    Автор: kaktak.net
    """

# Промпт: шаблон для структурированных запросов
@mcp.prompt()
def math_prompt(problem: str) -> str:
    """Промпт для математических задач"""
    return f"""
    Реши следующую математическую задачу, используя инструмент calculate:

    {problem}

    Покажи пошаговое решение.
    """

if __name__ == "__main__":
    mcp.run()

{
  "mcpServers": {
    "my-server": {
      "command": "python",
      "args": ["/полный/путь/к/server.py"]
    }
  }
}

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

const server = new McpServer({
  name: "my-server",
  version: "1.0.0",
});

// Регистрация инструмента
server.tool(
  "calculate",
  {
    operation: { type: "string", enum: ["add", "subtract", "multiply", "divide"] },
    a: { type: "number" },
    b: { type: "number" },
  },
  async ({ operation, a, b }) => {
    let result: number;

    switch (operation) {
      case "add":
        result = a + b;
        break;
      case "subtract":
        result = a - b;
        break;
      case "multiply":
        result = a * b;
        break;
      case "divide":
        if (b === 0) throw new Error("Деление на ноль");
        result = a / b;
        break;
      default:
        throw new Error(`Неизвестная операция: ${operation}`);
    }

    return {
      content: [{ type: "text", text: `Результат: ${result}` }],
    };
  }
);

// Запуск сервера
const transport = new StdioServerTransport();
await server.connect(transport);

{
  "mcpServers": {
    "my-server": {
      "command": "node",
      "args": ["/полный/путь/к/dist/index.js"]
    }
  }
}

@mcp.tool()
def search_database(query: str, limit: int = 10) -> list[dict]:
    """
    Поиск в базе данных.

    Args:
        query: Поисковый запрос
        limit: Максимальное количество результатов
    """
    # Логика поиска
    return results

@mcp.resource("config://database")
def get_db_config() -> str:
    """Конфигурация базы данных"""
    return json.dumps({
        "host": "localhost",
        "port": 5432,
        "database": "myapp"
    })

@mcp.prompt()
def code_review(language: str, code: str) -> str:
    """Промпт для ревью кода"""
    return f"""
    Проведи код-ревью следующего {language} кода:

    ```{language}
    {code}
    ```

    Обрати внимание на:
    1. Потенциальные баги
    2. Производительность
    3. Читаемость
    4. Best practices
    """