mcp-knowledge-base

MCP 클라이언트(Claude Desktop, IDE 또는 모든 에이전트)에 노트 지식 베이스를 노출하는 Model Context Protocol (MCP) 서버입니다. MCP 서버가 제공하는 두 가지, 즉 도구(모델이 호출할 수 있는 작업)와 리소스(모델이 읽을 수 있는 데이터)를 보여줍니다. TypeScript로 작성되었으며 stdio를 통해 실행됩니다.

제공하는 것

도구 (src/server.ts):

리소스: 모든 노트는 note://{id}에서 읽을 수 있으며 목록도 제공됩니다. 따라서 클라이언트는 도구를 호출하는 것뿐만 아니라 데이터로 지식 베이스를 탐색할 수 있습니다.

도메인 로직(노트 저장소 + 검색 순위)은 프로토콜 계층과 분리되어 src/notes.ts에 있습니다.

Related MCP server: simple-mcp-example

MCP 클라이언트와 함께 사용하기

빌드한 다음 클라이언트가 바이너리를 가리키게 하세요. 예를 들어 Claude Desktop의 claude_desktop_config.json에서:

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