MCP-сервер

Модульный сервер протокола контекста модели (MCP), созданный на базе FastAPI и предоставляющий инструменты для взаимодействия с LLM.

Возможности

• Модульная архитектура — каждый инструмент легко поддерживать

• Операции с файлами — чтение, запись, добавление, замена и вставка текста в файлы

• Веб-поиск — поиск в реальном времени с использованием DDGS

• Получение данных по URL — парсинг и создание сводок веб-контента

• Выполнение команд — запуск shell-команд в изолированной среде (песочнице)

• Строгая изоляция — песочница Bubblewrap с временной директорией /tmp

Related MCP server: mcp-toolkit

Инструменты

Установка

# Clone the repository
git clone <repository-url>
cd mcp_server

# Install dependencies using uv
uv sync

Использование

# Start the server
python main.py

Сервер будет запущен по адресу http://0.0.0.0:8000.

Архитектура

mcp_server/
├── main.py              # FastAPI application entry point
├── tools.json           # Tool definitions (JSON schema)
└── tools/               # Tool implementations
    ├── __init__.py      # Exports all handlers
    ├── add.py           # Math operations
    ├── today.py         # Date/time
    ├── web_search.py    # Web search
    ├── fetch_content.py # URL scraping
    ├── files.py         # All file operations
    └── run_command.py   # Shell command execution

Конфигурация песочницы

Инструмент run_command использует bubblewrap для изоляции:

• Файловая система root только для чтения (--ro-bind / /)

• Временная директория (--tmpfs /tmp)

• Директория ресурсов с правами записи (--bind resources resources)

• DNS-разрешение включено (без ограничений /etc)

Отказ от ответственности

Этот проект был разработан при содействии Qwen 3.6, большой языковой модели от лаборатории Tongyi Lab компании Alibaba Group. Хотя ИИ помогал в генерации кода, документации и рефакторинге, все технические решения и финальные реализации были проверены и подтверждены разработчиком-человеком.

Лицензия

Лицензия MIT