DIY MCP

Una implementación desde cero del Protocolo de Contexto del Modelo (MCP) para construir servidores y clientes, usando una colección de té chino como ejemplo.

GitHub
1
Prueba este MCPPatrocinado

Documentación

DIY MCP

Una implementación simple desde cero del Model Context Protocol (MCP) para construir servidores y clientes MCP usando stdio. Este ejemplo utiliza una colección simple de tés chinos con descripciones, orígenes, etc.

Para aplicaciones de producción, consulta los MCP SDKs oficiales.

MCP client CLI

Estructura del Proyecto

mcp/
├── server/           # MCP server for Chinese tea information
│   └── src/
│       ├── index.ts
│       ├── stdio.ts
│       └── teas.json
└── client/           # MCP client CLI with Claude as LLM
    └── src/
        ├── index.ts
        └── llm.ts

Servidor MCP

El núcleo de esta implementación es un servidor MCP ligero. Ofrece los siguientes recursos y herramientas:

  • Recursos:
    • tea://teas: Lista de todos los tés disponibles
    • tea://teas/{slug}: Detalles de un té específico
  • Herramientas:
    • getTeasByType: Obtener todos los tés de un tipo específico
    • getTeasByRegion: Obtener todos los tés de una provincia o región específica

Configuración

cd server
npm install
npm run build

Ejecución

Puedes probar el servidor MCP con MCP Inspector, una herramienta interactiva para probar y depurar servidores MCP.

cd server
npm run inspector

Cliente MCP

Puedes interactuar con el servidor MCP a través de un cliente MCP como Claude Desktop, o alternativamente, puedes usar el cliente DIY MCP incluido. Al agregar tu clave de API de Anthropic, puedes hacer que Claude determine inteligentemente qué herramientas usar según tu indicación.

El cliente proporciona tres modos de interacción:

  • Preguntar al LLM: Deja que Claude interactúe con el servidor MCP
  • Obtener un recurso: Accede directamente a los recursos del servidor MCP
  • Usar una herramienta: Llama directamente a las herramientas del servidor MCP

Configuración

cd client
npm install

Para usar Claude, primero copia el archivo de entorno de ejemplo y agrega tu clave de API de Anthropic con créditos disponibles a la variable ANTHROPIC_API_KEY:

cp .env.example .env

Ejecución

El cliente iniciará automáticamente el servidor MCP, así que asegúrate de haberlo compilado primero.

cd server
npm run build

cd client
npm start

Uso

Una vez en ejecución, puedes interactuar con el servidor MCP a través de la CLI del cliente MCP. Intenta hacerle algunas preguntas al LLM sobre el té chino:

  1. "¿Qué tés conoces?"
  2. "¿Qué tés vienen de Fujian?"
  3. "¿Cuál es tu té verde favorito?"

Recursos