mcp-knowledge-base

Un servidor Model Context Protocol (MCP) que expone una base de conocimiento de notas a los clientes MCP — Claude Desktop, IDEs o cualquier agente. Demuestra las dos cosas que proporciona un servidor MCP: herramientas (acciones que el modelo puede llamar) y recursos (datos que el modelo puede leer). TypeScript, se ejecuta sobre stdio.

Lo que expone

Herramientas (src/server.ts):

Recursos: cada nota es legible en note://{id}, con un listado — para que un cliente pueda explorar la base de conocimiento como datos, no solo llamar a herramientas.

La lógica de dominio (el almacén de notas + la clasificación de búsqueda) vive en src/notes.ts, separada de la capa de protocolo.

Related MCP server: simple-mcp-example

Úsalo con un cliente MCP

Compílalo y luego apunta un cliente al binario. Por ejemplo, en claude_desktop_config.json de Claude Desktop:

{
  "mcpServers": {
    "knowledge-base": { "command": "node", "args": ["/abs/path/to/dist/index.js"] }
  }
}

npm install && npm run build
node dist/index.js     # speaks MCP over stdio

Pruebas

npm test

Dos capas, ambas sin conexión:

• Unidad — el almacén de notas y la clasificación de búsqueda.

• Integración — un Client MCP real habla con el servidor a través de un transporte en memoria (de la misma manera que un cliente lo haría por stdio): lista herramientas, llama a search_notes/add_note/get_note y lee un recurso note://. 9 pruebas en total.

Licencia

MIT