东方项目-MCP

Name: 东方项目-MCP
Author: Hoshinonyaruko

作者：Hoshinonyaruko35 星标更新：2025-05-29

项目介绍

gensokyo

✨ 基于 OneBot 的 MCP Onebot 机器人 API 的 Go 语言原生实现 ✨

</div> <p align="center"> <a href="https://raw.githubusercontent.com/hoshinonyaruko/gensokyo-mcp/main/LICENSE"> <img src="https://img.shields.io/github/license/hoshinonyaruko/gensokyo" alt="license"> </a> <a href="https://github.com/hoshinonyaruko/gensokyo-mcp/releases"> <img src="https://img.shields.io/github/v/release/hoshinonyaruko/gensokyo?color=blueviolet&include_prereleases" alt="release"> </a> <a href="https://github.com/howmanybots/onebot/blob/master/README.md"> <img src="https://img.shields.io/badge/OneBot-v11-blue?style=flat&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAEAAAABABAMAAABYR2ztAAAAIVBMVEUAAAAAAAADAwMHBwceHh4UFBQNDQ0ZGRkoKCgvLy8iIiLWSdWYAAAAAXRSTlMAQObYZgAAAQVJREFUSMftlM0RgjAQhV+0ATYK6i1Xb+iMd0qgBEqgBEuwBOxU2QDKsjvojQPvkJ/ZL5sXkgWrFirK4MibYUdE3OR2nEpuKz1/q8CdNxNQgthZCXYVLjyoDQftaKuniHHWRnPh2GCUetR2/9HsMAXyUT4/3UHwtQT2AggSCGKeSAsFnxBIOuAggdh3AKTL7pDuCyABcMb0aQP7aM4AnAbc/wHwA5D2wDHTTe56gIIOUA/4YYV2e1sg713PXdZJAuncdZMAGkAukU9OAn40O849+0ornPwT93rphWF0mgAbauUrEOthlX8Zu7P5A6kZyKCJy75hhw1Mgr9RAUvX7A3csGqZegEdniCx30c3agAAAABJRU5ErkJggg==" alt="gensokyo"> </a> <a href="https://github.com/hoshinonyaruko/gensokyo-mcp/actions"> <img src="images/badge.svg" alt="action"> </a> <a href="https://goreportcard.com/report/github.com/hoshinonyaruko/gensokyo"> <img src="https[://goreportcard.com/badge/github.com/hoshinonyaruko/gensokyo" alt="GoReportCard"> </a> </p> <p align="center"> <a href="https://github.com/howmanybots/onebot/blob/master/README.md">文档</a> · <a href="https://github.com/hoshinonyaruko/gensokyo-mcp/releases">下载</a> · <a href="https://github.com/hoshinonyaruko/gensokyo-mcp/releases">开始使用</a> · <a href="https://github.com/hoshinonyaruko/gensokyo-mcp/blob/master/CONTRIBUTING.md">参与贡献</a> </p> <p align="center"> <a href="https://gensokyo.bot">项目主页:gensokyo.bot</a> </p>

兼容性

gensokyo 兼容 OneBot-v11。详情请参阅 OneBot 官方文档。支持使用 OneBot-v11 标准机器人的反向 WebSocket 作为 MCP 服务器。

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

koishi
nonebot2
trss
Zerobot
MiraiCQ
hoshino
tata
Paimon
Explosive Hair
Sanae
cultivate immortality
yobot
Mirai (Overflow)
支持 OneBot-v11 协议的其他相关项目

同时，gensokyo 支持连接到 VScode Line、Claude、OpenAI 和各种 MCP 支持的应用平台，并且可以与支持 OneBot-v11 适配器的其他项目结合使用。

开发者和用户无需重新开发插件，可以直接复用生态系统内的现有插件和用户体验。该项目持续改进中。欢迎加入交流群（196173384）参与测试或交流使用问题，随时提问，我们将及时回答并提供帮助。

主要用途

开发者测试
截图展示
个人娱乐
工具使用及效率扩展

MCP 服务使用方法

步骤 1：启动服务 运行 Gensokyo 后，项目会自动发布 config.yml 配置文件。

步骤 2：配置连接参数 在 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 早苗接入完整教程

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

渲染（连接到修仙插件）

<div align="center"> <img src="images/example1.png" alt="效果图" width="60%" /> <p>示例1：修仙插件界面</p> <img src="images/example2.png" alt="效果图" width="60%" /> <p>示例2：效果</p>

任何类型的 onebotv11 插件，如天气查询、游戏查询、娱乐等，都可以作为 MCP 服务器，瞬间将数千个 Onebotv11 生态系统插件转化为 AI 工具。

</div>

接口

由于该项目是基于 gensokyo wxmp 重构的，目前仅支持文本传输，仅支持与 Onebotv11 机器人应用的反向 ws 连接

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

扩展支持

扩展 API 可通过文档查看

[x] 连接多个 WS 地址
[x] MCP 用户信息虚拟群组事件/私聊事件
[x] 持续更新~

实现

符合 OneBot 标准的 API

API	功能
/send_group_masg √	[发送 MCP 回复消息]

</details> <details> <summary>已实现事件</summary>

符合 OneBot 标准的事件（某些事件报告比 OneBot 标准多几个字段，不影响使用）

事件类型	事件
消息事件	[MCP 信息虚拟私聊信息] TODO
消息事件	[MCP 信息虚拟群消息]

</details>

关于 ISSUE

以下 ISSUE 将直接关闭

不使用模板提交的 bug
询问已知的问题
问题无法找到关键点
重复问题

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

性能

10MB 内存占用，端口偏移允许多次稳定运行无误