Gensokyo-MCP

Gensokyo-MCP

3.5

If you are the rightful owner of Gensokyo-MCP and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

Gensokyo is a Golang-based native implementation of the OneBot MCP-Onebot robot API.

gensokyo

✨ 基于 OneBot MCP-Onebot机器人Api Golang 原生实现 ✨

文档 · 下载 · 开始使用 · 参与贡献

项目主页:gensokyo.bot

兼容性

gensokyo 兼容 OneBot-v11，详细信息请参考 OneBot 官方文档。 支持将 OneBot-v11 标准机器人的反向 WebSocket 作为 MCP Server。

以下项目均可无缝连接，包括：

  • koishi
  • nonebot2
  • trss
  • zerobot
  • MiraiCQ
  • hoshino
  • tata
  • 派蒙
  • 炸毛
  • 早苗
  • 修仙
  • yobot
  • Mirai (Overflow)
  • 以及其他支持 OneBot-v11 协议的相关项目

同时，gensokyo 支持连接至 VScode-Cline、Claude、OpenAI 以及各类支持 MCP 的应用平台，可以与其他支持 OneBot-v11 适配器的项目协同使用。

开发者和用户无需重新开发插件，可直接复用生态内的现有插件及使用体验。 项目持续完善中，欢迎加入交流群（196173384）参与测试或交流使用问题，欢迎随时提问，我们会及时为您解答与协助。

主要用途

  • 开发者测试
  • 截图展示
  • 个人娱乐
  • 工具使用与效率拓展

MCP 服务使用方式

第一步：启动服务 运行 gensokyo 后，项目会自动释放 config.yml 配置文件。

第二步：配置连接参数 在 config.yml 中，设置需要连接的 OneBot-v11 反向 WebSocket 地址。

以 cline 为例，配置方式如下。请注意 /sse/sse 路径出现了两次，确保地址填写无误：

{
  "mcpServers": {
    "gensokyo-mcp": {
      "autoApprove": [
        "call_ws"
      ],
      "disabled": false,
      "timeout": 30,
      "url": "http://127.0.0.1:8090/sse/sse",
      "transportType": "sse"
    }
  }
}
  • 支持本地连接（如示例所示），也支持远程连接，只需将 url 换为对应地址即可。
  • 其他 MCP 客户端的连接方式，可直接复制 cline 的配置模板，修改参数后使用。如有疑问，欢迎将配置发送至交流群，或询问 AI 获取针对性帮助。

教程索引

常见问题 如遇到连接异常或配置相关问题，请加入交流群 196173384 进行反馈，我们将协助你快速解决。

效果图（连接修仙插件）

示例1：修仙插件界面

示例2：效果

  • 任何onebotv11的插件类型,比如天气\游戏查询\娱乐均可作为MCP Server使用. 即刻将数千个Onebotv11生态插件转化为ai工具

接口

由于本项目是由gensokyo-wxmp重构的，目前仅支持传递文本，仅支持反向ws方式连接Onebotv11机器人应用.

  • [] HTTP API
  • [] 反向 HTTP POST
  • [] 正向 WebSocket
  • 反向 WebSocket

拓展支持

拓展 API 可前往 查看

  • 连接多个ws地址
  • 将MCP用户信息虚拟成群事件/私聊事件
  • 持续更新~

实现

已实现 API
符合 OneBot 标准的 API
API功能
/send_group_msg√[发送MCP回复消息]
已实现 Event
符合 OneBot 标准的 Event（部分 Event 比 OneBot 标准多上报几个字段，不影响使用）
事件类型Event
消息事件[MCP信息虚拟私聊信息]TODO
消息事件[MCP信息虚拟群消息]

关于 ISSUE

以下 ISSUE 会被直接关闭

  • 提交 BUG 不使用 Template
  • 询问已知问题
  • 提问找不到重点
  • 重复提问

请注意, 开发者并没有义务回复您的问题. 您应该具备基本的提问技巧。
有关如何提问，请阅读《提问的智慧》

性能

10mb内存占用 端口错开可多开 稳定运行无报错