Локальный MCP-сервер с Ollama

Локальный Python-проект, который подключает языковую модель Ollama к MCP-серверу. Модель может обнаруживать инструменты сервера, решать, когда вызвать один из них, получать результат и формировать краткий итоговый ответ.

flowchart TD
    U["User question"] --> C["Python MCP client"]
    C --> O["Ollama llama3.2:3b"]
    O --> C
    C --> S["Local MCP server"]
    S --> D["Student JSON data"]

Доступные инструменты

Related MCP server: py-mcp-students

Требования

• Python 3.11+

• Ollama установлена и запущена

• Модель Ollama llama3.2:3b

Настройка Windows

python -m venv venv
venv\Scripts\activate
pip install -r requirements.txt
ollama pull llama3.2:3b
python client.py

Клиент автоматически запускает server.py через активный интерпретатор Python. Вам не нужно запускать сервер в отдельном терминале.

Примеры вопросов

• What is 10 + 20?

• Tell me about Pranay.

• Where is Ananya studying?

• What is Saranya studying?

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

mcp-server/
├── client.py
├── server.py
├── files/
│   └── students.json
├── tests/
│   └── test_server.py
└── requirements.txt

Исправление результата инструмента

Ollama ожидает, что сообщение tool-result содержит tool_name выполненного инструмента. Клиент включает это поле и передаёт определения доступных инструментов в последующий вызов, что позволяет модели сформировать итоговый ответ после выполнения MCP-инструмента.

Примечание о данных

files/students.json содержит демонстрационные данные. Замените их на вымышленные данные или данные, полученные с согласия, прежде чем использовать этот проект публично или в производстве.