Servidor MCP local con Ollama

Un proyecto local en Python que conecta un modelo de lenguaje de Ollama a un servidor MCP. El modelo puede descubrir las herramientas del servidor, decidir cuándo llamar a una, recibir el resultado y producir una respuesta final concisa.

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"]

Herramientas disponibles

Related MCP server: py-mcp-students

Requisitos

• Python 3.11+

• Ollama instalado y en ejecución

• Modelo de Ollama llama3.2:3b

Configuración de Windows

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

El cliente ejecuta server.py automáticamente mediante el intérprete de Python activo. No es necesario iniciar el servidor en una terminal aparte.

Preguntas de ejemplo

• What is 10 + 20?

• Tell me about Pranay.

• Where is Ananya studying?

• What is Saranya studying?

Estructura del proyecto

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

Corrección del resultado de la herramienta

Ollama espera que un mensaje de resultado de herramienta incluya el tool_name ejecutado. El cliente incluye este campo y pasa las definiciones de herramientas disponibles a la llamada de seguimiento, lo que permite al modelo producir la respuesta final después de que se ejecute una herramienta MCP.

Nota sobre los datos

files/students.json son datos de demostración. Sustitúyelos con datos ficticios o con consentimiento antes de utilizar este proyecto públicamente o en producción.