Context Repo MCP

上下文回购MCP服务器

](https://www.npmjs.com/package/context-repo-mcp)  

MCP（模型上下文协议）服务器，使任何兼容MCP的客户端都能与您的 上下文报告 提示、文档和集合——通过渐进式披露搜索进行分层文档导航。

兼容的MCP客户端

此服务器适用于任何与MCP兼容的应用程序，包括：

• 克劳德桌面版 -Anthropic的桌面应用程序
• 光标IDE -AI驱动的代码编辑器
• 工厂Droid CLI -AI编码代理
• 任何其他支持 模型上下文协议

什么是MCP？

这 模型上下文协议 是一个开放标准，允许人工智能助手安全地连接到外部数据源和工具。此服务器使MCP客户端能够直接管理您的Context Repo内容。

特性

• 语义搜索 -通过AI驱动的相关性匹配，在所有内容中进行自然语言搜索
• 及时管理 -带有版本历史记录的完整CRUD：列表、查看、创建、更新、删除和还原提示
• 文档管理 -带有版本历史记录的完整CRUD：列表、查看、创建、更新、删除和还原文档
• 收集管理 -完整CRUD：列表、查看、创建、更新、删除集合，以及添加/删除项目
• 版本历史 -查看和恢复以前版本的提示和文档
• 渐进式披露搜索 -具有三级分块的分层文档搜索（文档→ 部分→ 段落）和定向导航
• 安全认证 -基于API密钥的身份验证

先决条件

• 18岁或以上
• 与MCP兼容的客户端应用程序
• 上下文报告 具有API密钥的帐户

安装

选项1：从npm全局安装

npm install -g context-repo-mcp

选项2：直接使用npx运行

无需安装-配置您的MCP客户端以使用 npx （见下面的配置示例）。

获取API密钥

1. 登录到…… 上下文报告
2. 首选 设置 → API密钥
3. 点击 创建API密钥
4. 选择权限：

- prompts.read -为了及时管理 - documents.read -用于文件和收藏访问

1. 复制密钥（以开头 gm_)

客户端配置

克劳德桌面版

步骤1：找到配置文件

macOS：

~/Library/Application Support/Claude/claude_desktop_config.json

窗户：

%APPDATA%\Claude\claude_desktop_config.json

步骤2：打开配置文件

macOS：

# Open in your default editor
open -e "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

# Or create it if it doesn't exist
mkdir -p "$HOME/Library/Application Support/Claude"
touch "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

窗户： 导航至 %APPDATA%\Claude\ 在文件资源管理器中打开或创建 claude_desktop_config.json.

步骤3：添加上下文回购服务器

添加 context-repo 进入您的 mcpServers 对象：

{
  "mcpServers": {
    "context-repo": {
      "command": "npx",
      "args": ["-y", "context-repo-mcp"],
      "env": {
        "CONTEXTREPO_API_KEY": "gm_your_api_key_here"
      }
    }
  }
}

如果您已经配置了其他MCP服务器，请添加 context-repo 与他们并肩：

{
  "mcpServers": {
    "existing-server": {
      "command": "...",
      "args": ["..."]
    },
    "context-repo": {
      "command": "npx",
      "args": ["-y", "context-repo-mcp"],
      "env": {
        "CONTEXTREPO_API_KEY": "gm_your_api_key_here"
      }
    }
  }
}

步骤4:重新启动克劳德桌面

macOS： 按 Cmd+Q 要完全退出，请重新打开Claude Desktop。

窗户： 按 Alt+F4 或者右键单击系统托盘图标并退出，然后重新打开。

步骤5：验证连接

1. 在Claude Desktop中打开新对话
2. 查找MCP工具指示灯（锤子图标🔨) 在输入框的右下角
3. 点击查看绿色状态的“上下文仓库”

光标IDE

一键安装： 访问 contextrepo.com/mcp-server 然后单击“安装到光标”按钮。

手动配置：

添加到光标MCP设置中：

{
  "mcpServers": {
    "context-repo": {
      "command": "npx",
      "args": ["-y", "context-repo-mcp"],
      "env": {
        "CONTEXTREPO_API_KEY": "gm_your_api_key_here"
      }
    }
  }
}

Factory.ai Droid命令行界面

Factory的Droid CLI可以直接从提示符自动安装MCP服务器。只需将此粘贴到任何Droid会话中：

Install the following MCP Server to Droid using the NPX method.  
MCP: https://github.com/Gitmaxd/context-repo-mcp
API Key: 

替换 ` 使用实际的API密钥（从 gm_`).

Droid将自动安装和配置MCP服务器，无需重新启动。

更喜欢手动配置？ 您可以使用与Droid MCP配置文件中显示的JSON格式相同的格式，将Context Repo MCP服务器直接添加到Droid MCP的配置文件中 其他MCP客户端 下面的部分。

其他MCP客户端

任何MCP客户端的通用配置模式：

{
  "command": "npx",
  "args": ["-y", "context-repo-mcp"],
  "env": {
    "CONTEXTREPO_API_KEY": "gm_your_api_key_here"
  }
}

或者，如果全局安装：

{
  "command": "context-repo-mcp",
  "env": {
    "CONTEXTREPO_API_KEY": "gm_your_api_key_here"
  }
}

可用工具

连接后，您的MCP客户端可以使用以下工具：

提示（7工具）

文档（7个工具）

收藏（7个工具）

搜索（1个工具）

渐进式披露（3个工具）

语义搜索

这 find_items 该工具支持在整个Context Repo中进行自然语言搜索。它不需要精确的关键字匹配，而是理解查询的含义。

运作原理

语义搜索使用AI嵌入来理解查询背后的含义：

1. 您的查询已转换 向量嵌入（意义的数值表示）
2. 内容匹配 针对存储在Context Repo中的文档/提示嵌入
3. 结果排名 按语义相似性（相关性得分0-1）
4. 收藏被评分 根据所含项目的相关性

参数

相关性评分

结果按相关性得分（0.0到1.0）过滤：

默认阈值：0.35 -低于此分数的结果将不予返回。

查询示例

查找相关内容：

"Search for my meeting notes"
"Find prompts about code review"
"What documents do I have about API design?"

按类型筛选：

"Search for 'project planning' in documents only"
"Find collection with my research materials"

文字搜索（完全匹配）：

"Search for 'README.md' with semantic disabled"

更好结果的提示

1. 具有描述性 -“编写技术文档的提示”比“文档”更有效
2. 使用自然语言 -像问同事一样问问题
3. 包括上下文 -“上次冲刺的会议笔记”比“笔记”更精确

渐进式披露搜索

这 deep_search, deep_expand，以及 deep_read 工具支持分层文档探索。渐进式披露不是返回整个文档，而是返回最具体的匹配块（段落、节或文档级别），并允许您围绕它导航层次结构。

运作原理

文档被组织成三级层次结构：

Document → Section → Paragraph

1. 文档被分块 分为三级层次结构（文档、章节、段落）
2. 矢量搜索结果 查询的最具体匹配级别
3. 浏览层次结构 使用展开方向（上、下、下、上、周围）
4. 会话跟踪看到的块 用于跨迭代搜索进行重复数据删除

三工具工作流程

• 第一步： deep_search --查找与您的查询匹配的相关块
• 第二步： deep_expand --导航到相关内容（父部分、子段落、兄弟姐妹）
• 步骤3： deep_read --获取特定块的完整详细信息和元数据

deep_search 参数

deep_expand 参数

deep_read 参数

方向参照

自动会话重复数据删除

deep_search 在第一次呼叫时自动创建会话。同一连接内的后续搜索排除了以前返回的块，从而实现了迭代细化，而不会看到重复的结果。提供明确的 sessionId 覆盖自动会话行为。

差异 find_items

查询示例

查找内容：

"Search for chunks about authentication"
"Find paragraphs mentioning API rate limits"

导航：

"Expand down from this section to see its paragraphs"
"Go up from this paragraph to see the full section"

深度检查：

"Read chunk [chunkId] for full details"

最佳效果提示

1. 开始 deep_search 然后使用 deep_expand 在层次结构中导航
2. 使用会话进行迭代改进 --默认情况下是自动创建的，因此重复搜索会自动跳过已经看到的块
3. 使用 deep_read 当您需要完整的元数据时 --部分路径、字数、标题文本和导航ID
4. 筛选依据 collectionId 或 documentId 在搜索之前缩小范围

示例用法

使用MCP客户端尝试以下命令：

提示

"List all my prompts"
"Search for prompts about code review"
"Create a prompt called 'Bug Report' for documenting software bugs"
"Show me the details of prompt [ID]"
"Update prompt [ID] with a new description"
"Delete prompt [ID]"
"Show me the version history of prompt [ID]"
"Restore prompt [ID] to version [VERSION_ID]"

文件

"List all my documents"
"Show me document [ID]"
"Create a document called 'Meeting Notes' with today's discussion"
"Update the title of document [ID]"
"Delete document [ID]"
"Show me the version history of document [ID]"
"Restore document [ID] to version [VERSION_ID]"

集合

"What collections do I have?"
"Create a collection called 'Project Alpha' with a blue color"
"Show me collection [ID] with all its items"
"Add document [ID] to collection [ID]"
"Remove prompt [ID] from collection [ID]"
"Delete collection [ID]"

搜索

"Search for documents about authentication"
"Find prompts related to code review"
"What do I have about project planning?"
"Search my collections for research materials"

渐进式披露

"Search for chunks about API authentication"
"Expand down from chunk [ID] to see child paragraphs"
"Expand up from this paragraph to see the full section"
"Read chunk [ID] for full details and hierarchy metadata"
"Search for more results about authentication" (with auto-session dedup)

故障排除

服务器未连接

1. 验证配置JSON是否有效
2. 确保完全重新启动MCP客户端
3. 检查是否安装了Node.js 18+： node --version

身份验证错误

• 验证您的API密钥以 gm_
• 检查Context Repo仪表板中的密钥是否未过期
• 确保密钥具有所需的权限

手动测试

CONTEXTREPO_API_KEY=gm_your_key_here npx context-repo-mcp

你应该看到创业横幅。按Ctrl+C退出。

发展

git clone https://github.com/Gitmaxd/context-repo-mcp.git
cd context-repo-mcp
npm install
npm test                                    # Run test suite (Vitest)
CONTEXTREPO_API_KEY=gm_your_key npm start

许可证

麻省理工学院-见 许可证

链接

• 上下文报告
• MCP文件

-