Thoughtbox MCP 服务器

关键词

上下文服务工具调用审计日志实时观测容器化部署

Thoughtbox 简介

Thoughtbox 是一个基于 MCP 的后端服务器，支持多代理协同推理、可审计的工作流和可观测的运行时数据。核心包含资源、工具和提示模板三大能力，并通过 JSON-RPC 与客户端进行标准化交互。提供完整的会话与工作区管理，以及实时可观测性、追踪与度量。

主要功能点

  • MCP 核心功能
    • 资源（Resources）：托管与管理数据资源，提供读取与订阅等能力。
    • 工具（Tools）：注册并执行外部功能调用，支持工具结果的结构化返回。
    • 提示模板（Prompts）：定义、渲染和管理对于 LLM 的输入提示模板。
  • 会话与协作
    • Hub/工作区、问题、提案、共识、渠道等原语，支持多代理协作、分支与回溯等模式。
    • 完整的审计记录：每一步都可追踪和可视化。
  • 通信与传输
    • 通过 JSON-RPC 进行请求/响应，支持多传输协议（stdio、HTTP、SSE 等）。
    • Observ Observatory 实时可视化、OpenTelemetry 指标和 Grafana/Prometheus 集成。
  • 观测与指标
    • Observatory UI（默认 http://localhost:1729）和数据指标（mcp_*、prometheus 兼容）。
  • 容器化和开发
    • Docker Compose 快速起步，包含核心 MCP 服务与观测堆栈。

安装与运行

  • 克隆代码并启动
    • 使用 Docker Compose 构建并启动整套 Thoughtbox 服务、观测堆栈等。
    • MCP 服务监听端口通常为 1731，Observatory UI 可在 1729 端口访问。
  • 客户端对接
    • Thoughtbox 通过 HTTP 传输（默认）与客户端连接，客户端配置需指向 MCP 服务的 /mcp 端点。

服务器配置（客户端需要的描述信息）

以下为示例配置信息（以 JSON 形式给出，客户端在连接时可使用）：

  • server name: thoughtbox
  • url: http://localhost:1731/mcp
  • transport: http 说明：该配置用于 MCP 客户端连接 Thoughtbox 提供的 MCP 服务。客户端在连接后即可使用 Thoughtbox 的资源、工具和模板等能力进行交互。

客户端常用配置示例（以 JSON 表示，便于理解）： { "servers": { "thoughtbox": { "url": "http://localhost:1731/mcp", "transport": "http" } // 备注：注释仅用于说明，不需要提交到配置文件中 } }

基本使用方法

  • 连接方式
    • 使用支持 MCP 的客户端（如 Claude Code、Cline、VS Code 等扩展）配置连接目标为 Thoughtbox 的 MCP 服务器地址（http://localhost:1731/mcp）。
  • 常用操作
    • 读取资源、调用工具、获取提示模板等标准 MCP 操作均通过 JSON-RPC 请求来完成，Thoughtbox 服务器端将返回 JSON-RPC 响应。
    • Observability UI：访问 http://localhost:1729 查看实时图形、指标和仪表盘。
  • 运行与调试要点
    • 确保 Docker 已启动，环境变量正确设置（如端口、数据目录等）。
    • 通过 docker compose 的服务名与网络进行交互，确保客户端能访问到 MCP 服务端口。

备注与参考

  • Thoughtbox 提供了完整的工具、资源、提示模板和工具集注册机制，便于在多代理协作场景下实现可观测、可审计的上下文服务。
  • 观测与监控部分依赖 OpenTelemetry、Prometheus/Grafana，便于在生产环境中追踪系统健康与性能。

服务器信息

访问项目