ContextKeeper MCP服务器
MCP（模型上下文协议）服务器 ContextKeeper -将您的上下文项与Cursor、Claude Desktop等AI助手集成。
它的作用
此MCP服务器允许AI助手直接通过自然语言读取和修改您的ContextKeeper项目。无需在编辑器和终端之间手动切换。
工具
| 工具 | 描述 | CLI等效工具 |
|---|---|---|
list_context_items | 列出所有带有ID、内容、项目、标签和状态的上下文项 | ck list |
add_context_item | 添加新的上下文项 | ck add |
mark_context_done | 将上下文项标记为已完成 | ck done |
get_context_status | 获取快速摘要（计数、项目、标签） | ck status |
search_context_items | 按查询字符串和/或标签搜索上下文项 | ck search |
remove_context_item | 按ID删除（存档）上下文项 | ck remove |
edit_context_item | 编辑现有上下文项的内容和/或标签 | ck edit |
sync_context_items | 触发上下文项与AI代理文件的同步 | ck sync |
命名规范
所有工具均遵循MCP最佳实践：
- 蛇病例:
list_context_items,add_context_item - 动词优先:
get_context_status,mark_context_done - 一致复数：全部使用
context_items（除status) - 与CLI对齐：每个工具直接映射到
ck命令
先决条件
- ContextKeeper命令行界面 (
ck)已安装并位于PATH中 - Node.js 18岁或以后
- npm 或 纱线
安装
选项1:npx（不安装）
npx @ondrahracek/contextkeeper-mcp选项2：来源
git clone https://github.com/ondrahracek/contextkeeper-mcp.git
cd contextkeeper-mcp
npm install
npm run build配置
光标IDE
增添 ~/.cursor/mcp.json:
{
"mcpServers": {
"contextkeeper": {
"command": "npx",
"args": ["-y", "@ondrahracek/contextkeeper-mcp"]
}
}
}或者，如果从源代码运行：
{
"mcpServers": {
"contextkeeper": {
"command": "node",
"args": ["/path/to/contextkeeper-mcp/build/index.js"]
}
}
}克劳德桌面
增添 ~/.config/claude/claude_desktop_config.json:
{
"mcpServers": {
"contextkeeper": {
"command": "npx",
"args": ["-y", "@ondrahracek/contextkeeper-mcp"]
}
}
}用法示例
在Cursor的聊天中，您可以说：
@contextkeeper我当前的环境是什么？
Claude将回复您的活动项目：
[
{
"id": "bc2839",
"fullId": "bc2839b5-6a8b-4b2a-9e1e-7b5c4d3e2f1a",
"content": "change tokens - find in whatsapp with...",
"project": "",
"tags": ["whatsapp"],
"completedAt": null,
"createdAt": "2026-02-08T21:25:00Z"
}
]或者：
@contextkeeper添加“查看安全中间件”
克劳德将添加项目并确认。
发展
# Install dependencies
npm install
# Run tests
npm test
# Build
npm run build
# Lint
npm run lint建筑
contextkeeper-mcp/
├── src/
│ ├── index.ts # MCP server entry point
│ ├── helpers.ts # CLI wrapper functions
│ └── types.ts # TypeScript type definitions
├── build/ # Compiled JavaScript output
└── package.json许可证
麻省理工学院-见 许可证 了解详情。
贡献
欢迎投稿！请在GitHub上打开问题或PR。