mcp-blackboard
2025.04.28
0
Python黑板内存服务多代理协作交流协作
mcp-blackboard 是一个轻量级的黑板内存服务器，专为模型上下文协议（MCP）设计。它提供了一个简单的 HTTP/SSE 接口，允许多个 AI 代理在共享的“黑板”上存储、检索和评分上下文（如文档、嵌入、结构化对象等）。该服务旨在无缝集成到任何 MCP 兼容的工作流中，使规划、研究和评估代理能够协作而无需重新实现持久化。
View on GitHub
Overview
基本能力
产品定位
mcp-blackboard 是一个轻量级的黑板内存服务器，用于在多个 AI 代理之间共享和协作上下文数据。
核心功能
- 统一内存：为代理上下文提供单一的真实来源，无需临时文件或 Redis 键。
- 文件系统抽象：基于
fsspec，支持 S3、Azure Blob、GCS、ABFS、SFTP、SMB 等远程文件系统。 - 实时更新：通过 Server-Sent Events (SSE) 即时将上下文更改流式传输给连接的代理。
- 家务调度器：可插拔的 cron 作业自动清理过期的键和刷新嵌入。
- 容器就绪：通过
uv锁文件实现确定性构建，Docker 镜像小于 90 MB。
适用场景
- 多代理协作工作流中需要共享和持久化上下文数据的场景。
- 需要实时更新和同步上下文数据的分布式 AI 系统。
- 需要灵活支持多种远程文件系统的存储解决方案。
使用教程
使用依赖
- 确保已安装 Python 3.12+ 和 Docker（如使用 Docker 方式运行）。
安装教程
本地开发环境
git clone https://github.com/your-org/mcp-blackboard.git
cd mcp-blackboard
# 创建隔离环境并安装依赖
uv venv
uv sync
# 复制示例环境文件并填写凭据
cp samples/env-sample.txt .env
# 运行服务器（FastAPI）
uv run src/main.py
Docker Compose
docker compose up -d
调试方式
- 运行测试套件：
pytest -q
- 检查 API 是否正常运行，默认监听
http://127.0.0.1:8000。