Clackbot MCP 服务器平台

关键词

本地化插件工具Claude Code 集成会话上下文机器人服务

使用说明 Markdown 版本

项目简介

  • Clackbot 是一个本地 Slack 机器人框架，内置对 MCP/Claude Code 的集成能力，能够以 MCP 的方式向客户端提供资源、工具和 Prompts 的管理与执行能力，并通过 JSON-RPC 形式对外提供可扩展的上下文服务。

主要功能点

  • MCP 服务加载与集成
    • 内置 MCP 服务器：将 clackbot 自带的工具集成为可被 MCP 客户端调用的服务器。
    • 插件与工具驱动：通过 .clackbot/tools JSON、插件注册和集成插件的 MCP 服务器，实现对外部工具的接入与调用。
  • 资源与知识管理
    • 支持本地资源、记忆（brain/memory）和项目上下文的管理，便于 LLM 在对话中调用与引用。
  • Prompts 与系统提示
    • 系统提示基于 CLAUDE.md、规则、技能及工具指南构成，支持多种对话模式（DM/线程/频道）。
  • JSON-RPC 与多传输
    • 通过内置的 MCP 服务器框架，向 MCP 客户端提供标准的请求/响应能力，当前实现具备基于 Claude Code 的 MCP 服务能力。
  • 会话与安全
    • 会话管理、权限判断、以及对 MCP 工具的安全策略（按拥有者/模式控制工具使用）。

安装步骤

  1. 环境准备
  • 需要 Node.js 18 及以上版本。
  1. 获取与安装
  • 克隆仓库并安装依赖。
  • 运行环境中会通过 CLI 命令配置与启动。
  1. 配置 MCP 服务器（关键点）

  • MCP 客户端需要连接的 MCP 服务器信息，写在配置文件中（config.json 的 mcpServers 字段），格式如下（JSON 结构说明，供 MCP 客户端使用；注意此处为服务器端的配置示例说明，实际客户端无需修改）：

    • name: 服务器名称，例如 trello-mcp-server
    • type: 服务器类型，可为 sse、http、stdio 三类之一
    • url: 当 type 为 sse/http 时的访问地址（如 http://localhost:5001/mcp）若为 stdio，则使用 command 与 args
    • command/args: 当 type 为 stdio 时的启动命令及参数
    • env/headers: 运行时所需的环境变量或请求头

    说明：根据仓库信息，Clackbot 提供内置 MCP 服务器 clackbot-builtin，以及从配置加载的外部 MCP 服务器和插件 MCP 服务器。MCP 客户端的连接信息以 config.json 的 mcpServers 字段表达，示例（非代码）如下：

    • name: trello-mcp-server type: http url: http://localhost:5001/mcp
    • name: github-mcp-server type: sse url: http://localhost:5002/mcp
    • name: custom-script type: stdio command: "node" args: ["./plugins/my-mcp-server/index.js"]
  1. 启动
  • 通过 Clackbot 提供的命令启动整套系统（包含 MCP 服务的集成能力）：
    • clackbot init
    • clackbot login
    • clackbot start
  • 启动后，MCP 相关服务会与配置中的 MCP 服务器进行对接，供 LLM 客户端按需调用。
  1. 使用与扩展
  • 使用 dashboard 与 MCP 服务管理页面来发现、安装与管理 MCP 服务器与工具。
  • 通过 .clackbot/tools/ 及插件机制扩展新的 MCP 服务与工具。

基本使用方法

  • 通过 MCP 客户端，向 Clackbot 提供的 MCP 服务器发起请求，以读取资源、调用工具、获取 Prompts 等，获取统一的 JSON-RPC 风格响应。
  • 服务器端负责会话上下文、能力声明、以及对多种传输协议（如 Stdio、SSE、WebSocket）的支持，供不同客户端使用场景接入。

关键词 本地化、MCP 集成、插件工具、对话上下文、Claude Code

分类ID 6

服务器信息

访问项目