Claude Server MCP

⚠️ 重要提示：项目状态 ⚠️

此项目处于早期开发阶段 (v0.1.0)，尚未准备好用于生产环境。目前正在进行重大重写，以解决几个关键问题。请查看 Issues 页面，了解当前的限制和计划的改进。

我们建议在任何关键工作流程中使用此项目之前，等待稳定版本 (v0.2.0+) 发布。

一个模型上下文协议 (MCP) 服务器，为 Claude 提供复杂的上下文管理功能，从而实现跨会话的持久上下文、项目特定的上下文组织和对话连续性。

当前限制

• 该服务器目前与 Claude Desktop 以外的 MCP 客户端存在兼容性问题
• 在没有特定项目 ID 的情况下，上下文列表功能受到限制
• 安全功能最少，尚未准备好用于生产环境
• 错误处理是基本的，可能无法提供有用的指导
• 没有测试基础设施

开发路线图

该项目正在积极改进。主要即将推出的增强功能包括：

1. 稳定性改进 - 修复主目录解析和上下文列表的核心问题
2. 增强的错误处理 - 更好的错误消息和恢复机制
3. 安全增强 - 输入验证、路径清理和数据保护
4. 高级上下文管理 - 版本控制、搜索和更好的组织

有关更详细的路线图，请参阅我们的 综合分析 分支。

功能

• 项目上下文管理

  • 分层上下文组织
  • 父子关系
  • 上下文之间的交叉引用
  • 项目特定的元数据

• 对话连续性

  • 基于会话的上下文跟踪
  • 对话链接
  • 富含元数据的上下文存储
  • 灵活的标签系统

• 高效存储

  • 有组织的目录结构
  • 基于 JSON 的存储
  • 快速查找索引
  • 异步操作

安装

服务器在您的 Claude 桌面应用程序的 MCP 设置中自动配置。所有上下文都存储在 ~/.claude/ 中，以便更好地组织：

~/.claude/
├── contexts/           # 常规对话上下文
├── projects/          # 项目特定的上下文
└── context-index.json # 快速查找索引

工具

项目上下文管理

// 保存项目上下文
use_mcp_tool({
  server_name: "claude-server",
  tool_name: "save_project_context",
  arguments: {
    id: "feature-design-v1",
    projectId: "my-project",
    content: "Design discussion...",
    parentContextId: "requirements-v1",
    references: ["api-spec-v1"],
    tags: ["design"],
    metadata: { status: "in-progress" }
  }
});

对话管理

// 保存对话上下文
use_mcp_tool({
  server_name: "claude-server",
  tool_name: "save_conversation_context",
  arguments: {
    id: "chat-2024-01-01",
    sessionId: "session-123",
    content: "Discussion content...",
    continuationOf: "previous-chat-id",
    tags: ["meeting"]
  }
});

上下文检索

// 获取上下文
use_mcp_tool({
  server_name: "claude-server",
  tool_name: "get_context",
  arguments: {
    id: "feature-design-v1",
    projectId: "my-project"
  }
});

// 列出上下文
use_mcp_tool({
  server_name: "claude-server",
  tool_name: "list_contexts",
  arguments: {
    projectId: "my-project",
    tag: "design",
    type: "project"
  }
});

文档

• 上下文管理指南 - 关于上下文类型和用法的详细指南
• 架构概述 - 技术实现细节
• 使用指南 - 一般使用说明
• Claude Desktop 集成 - 与 Claude Desktop 的集成

开发

1. 克隆存储库
2. 安装依赖项：

   npm install
   

3. 构建服务器：

   npm run build
   

4. 服务器将被构建到 build/index.js

配置

服务器通过 Claude 桌面应用程序的配置文件进行配置，该文件位于： ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "claude-server": {
      "command": "node",
      "args": ["/path/to/claude-server/build/index.js"]
    }
  }
}

贡献

欢迎贡献！请随时提交问题和拉取请求。

许可证

MIT