The Pensieve MCP Server

Pensieve MCP 服务

只需将多余的思绪从脑海中抽出，倒入冥想盆，再从容地仔细查看即可。你明白，以这种形式呈现时，更容易发现其中的模式和联系。

这是一个基于 TypeScript 的 MCP 服务，实现了一个基于 RAG 的知识管理系统。它通过提供以下功能来展示 MCP 的核心概念：

• 以 URI 和元数据表示已存储知识的资源
• 用于查询知识的自然语言界面
• 由大模型驱动的分析和响应合成

功能

资源

• 通过 memory:// URI 访问知识
• 包含结构化知识的 Markdown 文件
• 用于分类和检索的元数据

工具

• ask_pensieve - 查询已存储的知识
  • 接收自然语言问题
  • 使用大模型分析并检索相关信息
  • 根据已存储的知识提供上下文相关的回答

开发

安装依赖：

npm install

构建服务：

npm run build

启用自动重新构建以进行开发：

npm run watch

知识组织

将知识以 Markdown 文件的形式存储在根目录中：

1. 在文件名中使用清晰的类别（例如 skills-javascript.md）
2. 每个文件只包含一个主题
3. 添加相关元数据（日期、来源等）
4. 使用清晰、结构良好的内容

安装

要与 Claude Desktop 搭配使用，请添加服务配置：

MacOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "The Pensieve": {
      "command": "/path/to/The Pensieve/build/index.js"
    }
  }
}

调试

由于 MCP 服务通过 stdio 通信，调试可能颇具挑战。我们建议使用 MCP Inspector：

npm run inspector

Inspector 会提供一个 URL，供你在浏览器中访问调试工具。

async function handleQuestion(question: string) { // 1. 分析问题 const analysis = await server.request(SamplingCreateMessageRequestSchema, { messages: [{ role: "user", content: { type: "text", text: question } }], systemPrompt: "You are the Pensieve. Analyze questions to determine what knowledge to retrieve.", includeContext: "none" });

// 2. 使用现有的 RAG 查询（来自我们已运行的代码） const results = await ragPipeline.semanticSearch(analysis.content.text);

// 3. 撰写回答 const response = await server.request(SamplingCreateMessageRequestSchema, { messages: [{ role: "user", content: { type: "text", text: Answer using this knowledge: ${results.map(r => r.payload.full_text).join('\n')} } }], systemPrompt: "You are the Pensieve. Provide clear answers based on stored knowledge.", includeContext: "none" });

return response.content.text; }

const documentGuide = `为 Pensieve 准备文档：

1. 将文件放在根目录中
2. 在文件名中使用清晰的类别（例如 skills-javascript.md）
3. 每个文件只包含一个主题
4. 内容清晰、结构良好
5. 添加相关元数据（日期、来源等）`;

{ uri: "memory://knowledge/skills-javascript.md", mimeType: "text/markdown", // 因为我们使用的是 Markdown 文件 name: "JavaScript Skills", description: "关于 JavaScript 开发的知识" }