GO

Gensokyo-MCP

by Hoshinonyaruko/Gensokyo-MCP

1 views

OnebotV11 Bot as MCP Server.

gointegrationChat & Messaging

gensokyo

gensokyo

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

license release gensokyo action GoReportCard

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

项目主页: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内存占用 端口错开可多开 稳定运行无报错

Install

No configuration available
For more configuration details, refer to the content on the left

Related

Related projects feature coming soon

Will recommend related projects based on sub-categories