Claude session coordinator

克劳德会议协调员

一个灵活的MCP服务器，支持多个Claude AI会话，通过共享状态管理协调跨机器的工作。

⚠️ 重要免责声明

无隶属关系： 克劳德会议协调员（CSC）和BANCS AS与Anthropic PBC没有附属关系，也没有雇佣、认可或赞助。我们没有从Anthropic获得任何补偿或支持。这是一个独立的社区项目。

使用风险自负： 本软件按“原样”提供，不提供任何形式的保修。用户承担与使用此工具相关的所有风险。

无官方支持： Anthropic尚未审查、批准或认可此工具。Anthropic不对该工具的功能或支持负责。

概述

Claude会话协调器提供了一个基于存储适配器的MCP服务器，使多个Claude会话能够：

• 共享状态并协调工作
• 并行工作时避免冲突
• 跨会话跟踪进度
• 支持多种工作流模式

核心理念： 灵活的原语胜过固执己见的工作流程。服务器提供了支持任何协调模式的简单、通用的构建块。

项目结构

这是一个包含以下内容的monorepo：

• packages/mcp-server/ -带存储适配器的Python MCP服务器
• packages/homepage/ -公共文档网站（用于第2+阶段发布）
• docs/ -共享架构和实施文档

快速开始

对于贡献者/发展

先决条件：

• Python 3.10+
• Node.js 18+
• npm（附带Node.js）

设置：

# 1. Clone the repository
git clone https://github.com/BANCS-Norway/claude_session_coordinator.git
cd claude_session_coordinator

# 2. Install git hooks (automatic linting on commit)
npm install

# 3. Install Python MCP server package
cd packages/mcp-server
pip install -e ".[dev]"

看 贡献.md 详细的开发指南。

用户（第1阶段-开发）

cd packages/mcp-server
pip install -e .

Claude Code快速入门

1. 安装MCP服务器：

   cd packages/mcp-server
   pip install -e ".[dev]"

1. 配置克劳德代码：

   # Copy the template
   cp .mcp.json.template .mcp.json

   # Edit with your paths
   nano .mcp.json

1. 更新 .mcp.json 根据您的实际路径：

   {
     "mcpServers": {
       "claude-session-coordinator": {
         "command": "/path/to/your/python3",
         "args": [
           "-m",
           "claude_session_coordinator"
         ],
         "env": {},
         "cwd": "/path/to/claude_session_coordinator"
       }
     }
   }

1. 重新启动Claude Code-会话协调器将自动可用！

特性

存储适配器

• 本地文件适配器 （第1阶段）-简单的JSON文件存储
• Redis适配器 （第2+阶段）-跨机器协调
• 自定义适配器 -实现自己的后端

MCP工具

• sign_on() -声明实例并建立会话标识
• store_data() -在作用域上下文中存储数据
• retrieve_data() -检索存储的数据
• list_keys() -发现范围内的可用密钥
• list_scopes() -列出所有具有可选筛选的范围
• delete_data() -删除特定数据
• delete_scope() -删除整个范围
• sign_off() -释放会话实例

MCP资源

• session://context -当前会话状态和可用实例
• session://state/{id} -读取其他会话的状态（协调）

MCP提示

• startup -指导克劳德完成登录过程
• sign-off -指导正确的会话发布

开发状态

第一阶段 （当前）：MCP服务器核心实现

• 存储适配器体系结构
• 本地文件适配器
• 核心MCP工具、资源和提示
• 内部测试和迭代

第2阶段 （未来）：公开发布

• 主页和文档网站
• PyPI出版
• 社区公告

第三阶段+ （未来）：生态系统

• VS代码扩展
• CLI工具
• Web仪表板
• 附加适配器

文档

• 架构概述
• 存储适配器
• 实施计划
• 用例

贡献

看 贡献.md 作为指导方针。

许可证

MIT许可证-请参阅 许可证 了解详情。

支持

这是一个社区项目。对于问题和功能请求，请使用GitHub issues。

______________________________________________________________________

由社区建造，为社区服务 🚀