Gensokyo-MCP

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

项目主页: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 获取针对性帮助。

教程索引

💙 Windows 端 VSCode-Cline + gensokyo-mcp 早苗接入完整教程

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

效果图（连接修仙插件）

接口

由于本项目是由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内存占用 端口错开可多开 稳定运行无报错