mcp-knowledge-base

Ein Model Context Protocol (MCP)-Server, der eine Notiz-Wissensdatenbank für MCP-Clients bereitstellt – Claude Desktop, IDEs oder beliebige Agenten. Er demonstriert die zwei Dinge, die ein MCP-Server bietet: Tools (Aktionen, die das Modell aufrufen kann) und Ressourcen (Daten, die das Modell lesen kann). TypeScript, läuft über stdio.

Was er bereitstellt

Tools (src/server.ts):

Ressourcen: Jede Notiz ist unter note://{id} lesbar, mit einer Auflistung – so kann ein Client die Wissensdatenbank als Daten durchsuchen, nicht nur Tools aufrufen.

Die Domänenlogik (der Notizspeicher + Suchranking) befindet sich in src/notes.ts, getrennt von der Protokollschicht.

Related MCP server: simple-mcp-example

Verwendung mit einem MCP-Client

Erstellen Sie es und richten Sie dann einen Client auf die Binärdatei aus. Zum Beispiel in der claude_desktop_config.json von 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

Tests

npm test

Zwei Ebenen, beide offline:

• Unit – der Notizspeicher und das Suchranking.

• Integration – ein echter MCP-Client spricht mit dem Server über einen In-Memory-Transport (so wie ein Client über stdio): Er listet Tools auf, ruft search_notes/add_note/get_note auf und liest eine note://-Ressource. Insgesamt 9 Tests.

Lizenz

MIT