Решение проблем

@mcp.resource("config://settings")  # Точный URI
def get_settings():
    return {"theme": "dark"}

# ❌ Зарегистрировано
@mcp.resource("config://settings")

# ❌ Запрашивается (не совпадает)
# "config://setting"  — нет 's' в конце
# "config:/settings"  — одна косая черта
# "settings"          — нет схемы

# ✅ Правильный запрос
# "config://settings"

@mcp.tool()  # Декоратор обязателен
def my_tool(param: str) -> str:
    """Описание инструмента"""
    return f"Result: {param}"

# Имя берётся из имени функции
@mcp.tool()
def calculate_sum(a: int, b: int) -> int:  # Имя: "calculate_sum"
    return a + b

# Или можно задать явно
@mcp.tool(name="sum")  # Имя: "sum"
def calculate_sum(a: int, b: int) -> int:
    return a + b

// ❌ Неправильно: относительный путь
{
  "mcpServers": {
    "my-server": {
      "command": "python",
      "args": ["server.py"]
    }
  }
}

// ✅ Правильно: абсолютный путь
{
  "mcpServers": {
    "my-server": {
      "command": "/usr/bin/python3",
      "args": ["/Users/me/project/server.py"]
    }
  }
}

// ❌ Неправильно: лишняя запятая
{
  "mcpServers": {
    "my-server": {
      "command": "python",
      "args": ["server.py"],  // <-- Лишняя запятая!
    }
  }
}

// ✅ Правильно
{
  "mcpServers": {
    "my-server": {
      "command": "python",
      "args": ["server.py"]
    }
  }
}

Error: connection refused
Error: password authentication failed
Error: database "xxx" does not exist

import os
from mcp.server.fastmcp import FastMCP

mcp = FastMCP("db-server")

# 1. Проверьте DATABASE_URL
DATABASE_URL = os.getenv("DATABASE_URL")
if not DATABASE_URL:
    raise ValueError("DATABASE_URL не установлена")

# 2. Проверьте формат URL
# postgresql://user:password@host:port/database
# postgresql://postgres:secret@localhost:5432/mydb

# 3. Используйте connection pool
import asyncpg

pool = None

@mcp.tool()
async def query_db(sql: str) -> str:
    global pool
    if pool is None:
        pool = await asyncpg.create_pool(DATABASE_URL)

    async with pool.acquire() as conn:
        result = await conn.fetch(sql)
        return str(result)

Error: unable to open database file
Error: database is locked

import sqlite3
import os

# 1. Проверьте путь к файлу
db_path = "/path/to/database.db"
if not os.path.exists(db_path):
    raise FileNotFoundError(f"БД не найдена: {db_path}")

# 2. Используйте правильные флаги
conn = sqlite3.connect(
    db_path,
    check_same_thread=False,  # Для многопоточности
    timeout=30.0  # Таймаут блокировки
)

# 3. Для read-only доступа
conn = sqlite3.connect(f"file:{db_path}?mode=ro", uri=True)

{
  "mcpServers": {
    "my-server": {
      "command": "/path/to/venv/bin/python",
      "args": ["/path/to/server.py"]
    }
  }
}

{
  "mcpServers": {
    "my-server": {
      "command": "uvx",
      "args": ["--from", "mcp", "mcp", "run", "server.py"]
    }
  }
}

{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": ["ts-node", "/path/to/server.ts"]
    }
  }
}

@mcp.tool()
async def long_operation(data: str) -> str:
    """Долгая операция"""
    # Уведомляем о прогрессе
    await mcp.request_context.session.send_progress(
        progress=0, total=100, message="Начинаю обработку..."
    )

    # Делаем работу
    result = await process_data(data)

    await mcp.request_context.session.send_progress(
        progress=100, total=100, message="Готово!"
    )

    return result

import asyncio
import aiohttp

@mcp.tool()
async def fetch_data(url: str) -> str:
    """Получить данные из URL"""
    async with aiohttp.ClientSession() as session:
        async with session.get(url, timeout=30) as response:
            return await response.text()

@mcp.tool()
def get_file(path: str) -> str:
    """Читает файл (макс 100KB)"""
    MAX_SIZE = 100 * 1024

    with open(path, 'r') as f:
        content = f.read(MAX_SIZE)

    if len(content) == MAX_SIZE:
        content += "\n... (файл обрезан)"

    return content

{
  "mcpServers": {
    "server1": { "command": "python", "args": ["server1.py"] },
    "server2": { "command": "python", "args": ["server2.py"] }
  }
}

{
  "mcpServers": {
    "my-server": {
      "command": "python",
      "args": ["server.py"],
      "env": {
        "API_KEY": "xxx",
        "DATABASE_URL": "postgresql://..."
      }
    }
  }
}