返回市场
克劳德服务器

克劳德服务器

作者:davidteren15 星标更新:2025-03-16

项目介绍

Claude Server MCP

⚠️ 重要:项目状态 ⚠️

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

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

这是一个提供复杂上下文管理能力的模型上下文协议(MCP)服务器,使Claude能够在会话之间保持持久的上下文,组织特定项目的上下文,并实现对话连续性。

当前限制

  • 该服务器目前与其他MCP客户端(除了Claude Desktop)存在兼容性问题
  • 在没有具体项目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: "设计讨论...",
    parentContextId: "requirements-v1",
    references: ["api-spec-v1"],
    tags: ["设计"],
    metadata: { status: "进行中" }
  }
});

对话管理

// 保存对话上下文
use_mmcp_tool({
  server_name: "claude-server",
  tool_name: "save_conversation_context",
  arguments: {
    id: "chat-2024-01-01",
    sessionId: "session-123",
    content: "讨论内容...",
    continuationOf: "previous-chat-id",
    tags: ["会议"]
  }
});

上下文检索

// 获取上下文
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: "设计",
    type: "项目"
  }
});

文档

开发

  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