gremlin_mcp

Изучение по этому уроку на YouTube https://www.youtube.com/watch?v=io02ZM0ADqM MCP Full Course for Beginners Примечание: Я попросил Copilot или другую LLM очистить существующий код для инструментов и добавил те, которые, по её мнению, могли бы быть полезны. Несколько инструментов следует использовать с осторожностью, так как они могут изменять файлы и каталоги. Я не проверял использование инструментов должным образом. Нужно создать что-то полезное с этим MCP и с соответствующими ограничениями.

Сервер MCP (Model Context Protocol), который предоставляет агенту возможности терминала и управления файлами: запуск команд shell/Python, поиск и чтение файлов, создание/редактирование/удаление файлов и папок.

Построен на FastMCP.

Инструменты

Сервер предоставляет 21 инструмент, сгруппированных следующим образом:

Выполнение команд shell/Python

Поиск и чтение

Файлы и папки

Related MCP server: emcp

Требования

• Python >= 3.13

• fastmcp >= 3.4.7

Установка

uv sync            # recommended
# or
python -m pip install -e .

Запуск сервера

Сервер общается через stdio, что является транспортом по умолчанию для FastMCP. Запустите его из корня репозитория любой из следующих команд:

uv run python -m gremlin_mcp.main
python test.py serve
python start_gremlin_mcp_server.py

Тестирование

1. Автономная проверка (без MCP-клиента)

python test.py

Этот импорт сервера вызывает каждый инструмент (создавая и удаляя временную папку) и выводит сводку [PASS]/[FAIL] вместе с общим итогом.

2. Интерактивный веб-инспектор

fastmcp dev inspector src/gremlin_mcp/main.py

Открывает MCP Inspector в вашем браузере, чтобы вы могли просматривать инструменты, читать их описания/примеры и вызывать их интерактивно.

Примечание: fastmcp dev — это группа подкоманд, поэтому подкоманду inspector нужно передавать явно (просто fastmcp dev src/... не сработает).

3. Быстрые проверки через CLI

fastmcp inspect src/gremlin_mcp/main.py    # server info + tool summary
fastmcp list   src/gremlin_mcp/main.py     # just the tool names

4. Подключение из MCP-клиента

Настройте конфигурацию MCP вашего редактора/клиента для подключения к серверу через stdio, например:

{
  "mcpServers": {
    "gremlin-mcp": {
      "command": "uv",
      "args": ["run", "python", "-m", "gremlin_mcp.main"]
    }
  }
}

Примеры вызовов инструментов

Как их мог бы вызвать агент:

list_dir(path="src")
search_text(pattern="TODO", directory="src")
read_file(file="pyproject.toml")
write_file(file="hello.py", content="print('hi')")
python_code(code="print(6 * 7)")          # -> exit=0 / 42
replace_in_file(path="config.py", old="DEBUG = True", new="DEBUG = False")
tree(path=".", depth=2)

Структура проекта

src/gremlin_mcp/
├── __init__.py
├── tools.py   # all tool definitions (21 tools)
└── main.py    # FastMCP server entry point
test.py        # offline smoke test / optional server launcher
start_gremlin_mcp_server.py   # minimal "run the server" launcher

Замечание по безопасности

run_command, python_code и python_file выполняют произвольный код. Предоставляйте этот сервер только тем агентам/клиентам, которым вы доверяете, и рассмотрите возможность запуска его в песочнице или в ограниченной рабочей директории.