py-mcp-сервер-шаблон

Этот репозиторий — шаблон, который поможет вам создать собственные серверы MCP (Model Context Protocol) на Python. Сделайте форк этого репозитория, чтобы начать.

Настройка с УФ

Этот проект использует uv для упаковки Python и управления виртуальной средой. Если у вас не установлен uv , обратитесь к официальному руководству по установке uv .

1. Клонируйте ваш разветвленный репозиторий:

   git clone https://github.com/YOUR_USERNAME/YOUR_REPOSITORY_NAME.git
   cd YOUR_REPOSITORY_NAME

2. Создайте и активируйте виртуальную среду: uv обычно создает каталог .venv в корне вашего проекта.

   uv venv
   source .venv/bin/activate  # On macOS/Linux
   # .venv\Scripts\activate   # On Windows

3. Установка зависимостей: этот проект использует pyproject.toml для управления зависимостями.

   uv pip install .

   Если вы добавляете новые зависимости, определите их в файле pyproject.toml и снова выполните эту команду. Если по какой-то причине вы используете файл requirements.txt , вы можете установить его с помощью uv pip install -r requirements.txt .

Related MCP server: mcp-framework-starter

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

Скрипт mcp_server.py запускает сервер MCP.

Чтобы запустить сервер напрямую:

uv run python mcp_server.py

Интеграция с Claude Desktop или Cursor

Чтобы использовать этот сервер MCP с приложением вроде Claude Desktop или Cursor, вам нужно настроить его в настройках приложения. Конфигурация обычно включает указание команды для запуска вашего сервера.

Вот пример фрагмента конфигурации. Вам нужно будет заменить /ABSOLUTE/PATH/TO/PARENT/FOLDER/YOUR_REPOSITORY_NAME на фактический абсолютный путь к каталогу вашего проекта в вашей системе.

{
    "mcpServers": {
        "my-custom-python-server": {
            "command": "uv",
            "args": [
                "run",
                "--python",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/YOUR_REPOSITORY_NAME/.venv/bin/python",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/YOUR_REPOSITORY_NAME/mcp_server.py"
            ],
            "workingDirectory": "/ABSOLUTE/PATH/TO/PARENT/FOLDER/YOUR_REPOSITORY_NAME"
        }
    }
}

Пояснение конфигурации:

• "my-custom-python-server" : это имя, которое вы даете конфигурации вашего сервера.

• "command": "uv" : Указывает uv как команду для выполнения.

• "args" : список аргументов для команды uv :

  • "run" : сообщает uv о необходимости выполнить команду в управляемой среде.

  • "--python" : Указывает интерпретатор Python для использования. Важно указать интерпретатор Python внутри вашей виртуальной среды uv ( .venv/bin/python ).

  • "/ABSOLUTE/PATH/TO/PARENT/FOLDER/YOUR_REPOSITORY_NAME/mcp_server.py" : абсолютный путь к скрипту вашего сервера.

• "workingDirectory" : указывает рабочий каталог для серверного процесса, который должен быть корневым каталогом вашего проекта.

Важный:

• Убедитесь, что пути в args и workingDirectory верны для вашей системы.

• Если приложение не может найти uv , вам может потребоваться указать его полный путь в поле "command" . Обычно этот путь можно найти, запустив which uv в терминале на macOS или Linux или where uv на Windows.

• По умолчанию сервер прослушивает stdio , как настроено в mcp_server.py ( mcp.run(transport='stdio') ), что обычно и ожидается от таких приложений, как Cursor.

После настройки приложение должно иметь возможность взаимодействовать с вашим сервером Python MCP.