Claude Server MCP

⚠️ 重要：项目状态 ⚠️

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

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

一个提供复杂上下文管理功能的 Model Context Protocol (MCP) 服务器，支持 Claude 的会话间持久化上下文、特定项目的上下文组织以及对话连续性。

当前限制

• 该服务器目前与其他 MCP 客户端（除了 Claude Desktop）存在兼容性问题
• 没有特定项目 ID 的情况下，上下文列表功能有限
• 安全特性很少且不适用于生产环境
• 错误处理较为基础，可能无法提供有用的指导
• 尚未建立测试基础设施

开发路线图

该项目正在积极改进中。即将推出的关键增强包括：

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

有关更详细的路线图，请参阅我们的 Comprehensive Analysis 分支。

功能

• 项目上下文管理

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

• 对话连续性

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

• 高效存储

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

安装

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

~/.claude/
├── contexts/           # General conversation contexts
├── projects/          # Project-specific contexts
└── context-index.json # Quick lookup index

工具

项目上下文管理

// Save project context
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" }
  }
});

对话管理

// Save conversation context
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"]
  }
});

上下文检索

// Get context
use_mcp_tool({
  server_name: "claude-server",
  tool_name: "get_context",
  arguments: {
    id: "feature-design-v1",
    projectId: "my-project"
  }
});

// List contexts
use_mcp_tool({
  server_name: "claude-server",
  tool_name: "list_contexts",
  arguments: {
    projectId: "my-project",
    tag: "design",
    type: "project"
  }
});

文档

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

开发

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