金大哥 - claude-server MCP 详情

article

README

🚀 代号：Claude Server MCP

这是一个提供高级上下文管理功能的模型上下文协议（MCP）服务器，支持跨会话的持久上下文、基于项目的上下文组织以及对话连续性，为Claude提供强大的上下文管理能力。

🚀 快速开始

该项目处于早期开发阶段（v0.1.0），尚未准备好投入生产使用。它正在经历重大重构以解决多个关键问题。请查看问题页面了解当前限制和改进计划。

我们建议在稳定版本（v0.2.0+）发布之前，不要将此项目用于任何关键工作流程。

✨ 主要特性

项目上下文管理
- 层次式上下文组织，支持父子关系，方便上下文之间的交叉引用，还能存储项目特定元数据。
对话连续性
- 基于会话的上下文跟踪，采用对话链式处理，拥有丰富的上下文存储元数据和灵活的标签系统。
高效存储
- 具备整洁的目录结构，以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: "parent-feature-design",
    contextType: "design"
  }
});

对话上下文管理

// 创建新对话上下文
use_mcp_tool({
  server_name: "claude-server", 
  tool_name: "create_dialog_context",
  arguments: {
    sessionId: "12345",
    contextId: "welcome-message"
  }
});

📚 详细文档

项目文档位于DOCS.md。

🔧 技术细节

当前限制

该服务器目前仅与Claude Desktop等特定MCP客户端兼容。
在没有具体项目ID的情况下，上下文列表功能受限。
安全功能最少且不适合生产环境使用。
错误处理基础，可能无法提供有用指导。
没有测试基础设施。

开发路线图

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

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

详细了解请查看我们的全面分析分支。

📄 许可证

MIT

⚠️ 重要提示

该项目处于早期开发阶段（v0.1.0），尚未准备好投入生产使用。它正在经历重大重构以解决多个关键问题。请查看问题页面了解当前限制和改进计划。我们建议在稳定版本（v0.2.0+）发布之前，不要将此项目用于任何关键工作流程。

💡 使用建议

可以关注项目的开发路线图，等待稳定版本发布后再应用于关键工作流程。同时，可参考详细文档进行使用和开发。

claude-server