Архитектура MCP

@mcp.tool()
def send_email(to: str, subject: str, body: str) -> str:
    """Отправить email"""
    # Реализация...
    return "Email отправлен"

// Запрос: tools/call
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "send_email",
    "arguments": {
      "to": "user@example.com",
      "subject": "Hello",
      "body": "Message"
    }
  }
}

// Ответ
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {"type": "text", "text": "Email отправлен"}
    ]
  }
}

@mcp.resource("config://settings")
def get_settings() -> str:
    """Настройки приложения"""
    return json.dumps({"theme": "dark", "lang": "ru"})

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

    ```{language}
    {code}

**Характеристики:**
- Генерируют текст для AI
- Принимают аргументы
- Упрощают типовые задачи

---

## JSON-RPC 2.0

MCP использует JSON-RPC 2.0 для всей коммуникации.

### Формат запроса

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "method_name",
  "params": { ... }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": { ... }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32600,
    "message": "Invalid Request",
    "data": { ... }
  }
}

{
  "jsonrpc": "2.0",
  "method": "notifications/progress",
  "params": {
    "progress": 50,
    "total": 100
  }
}

// Запрос
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2024-11-05",
    "capabilities": {
      "roots": { "listChanged": true }
    },
    "clientInfo": {
      "name": "Claude Desktop",
      "version": "1.0.0"
    }
  }
}

// Ответ
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "protocolVersion": "2024-11-05",
    "capabilities": {
      "tools": {},
      "resources": { "subscribe": true },
      "prompts": {}
    },
    "serverInfo": {
      "name": "my-server",
      "version": "1.0.0"
    }
  }
}

{
  "jsonrpc": "2.0",
  "method": "notifications/initialized"
}

{
  "type": "text",
  "text": "Результат операции"
}

{
  "type": "image",
  "data": "base64_encoded_image_data",
  "mimeType": "image/png"
}

{
  "type": "resource",
  "resource": {
    "uri": "file:///path/to/file.txt",
    "mimeType": "text/plain",
    "text": "Содержимое файла"
  }
}

{
  "capabilities": {
    "tools": {},
    "resources": {
      "subscribe": true,
      "listChanged": true
    },
    "prompts": {
      "listChanged": true
    },
    "logging": {}
  }
}

{
  "capabilities": {
    "roots": {
      "listChanged": true
    },
    "sampling": {}
  }
}