mcp-knowledge-base

Сервер Model Context Protocol (MCP), который предоставляет базу знаний заметок клиентам MCP — Claude Desktop, IDE или любому агенту. Он демонстрирует две вещи, которые предоставляет MCP-сервер: инструменты (действия, которые модель может вызывать) и ресурсы (данные, которые модель может читать). TypeScript, работает через stdio.

Что он предоставляет

Инструменты (src/server.ts):

Ресурсы: каждая заметка доступна для чтения по адресу note://{id}, со списком — так что клиент может просматривать базу знаний как данные, а не только вызывать инструменты.

Доменная логика (хранилище заметок + ранжирование поиска) находится в src/notes.ts, отдельно от протокольного уровня.

Related MCP server: simple-mcp-example

Использование с MCP-клиентом

Соберите его, затем укажите клиенту на бинарный файл. Например, в claude_desktop_config.json для 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

Тесты

npm test

Два уровня, оба офлайн:

• Модульные — хранилище заметок и ранжирование поиска.

• Интеграционные — реальный MCP Client общается с сервером через транспорт в памяти (так же, как клиент общался бы через stdio): он перечисляет инструменты, вызывает search_notes/add_note/get_note и читает ресурс note://. Всего 9 тестов.

Лицензия

MIT