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 获取针对性帮助。

教程索引

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

常见问题 如遇到连接异常或配置相关问题，请加入交流群 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内存占用端口错开可多开稳定运行无报错

Gensokyo-MCP