astrbot-mcp
AstrBot MCP Server — 提供 AstrBot 插件开发相关的工具接口。
功能
- get_doc: 获取 AstrBot 开发文档内容
- list_docs: 列出所有可用文档
- search_docs: 按关键词搜索文档
- get_hook_inventory: 获取完整的 Hook 清单
安装
前置要求
- Python 3.10+
- AstrBot-Skill 仓库（提供文档引用）
配置
- Clone 本仓库和 AstrBot-Skill 到同一目录下：
mkdir astrbot-workspace && cd astrbot-workspace
git clone https://github.com/EterUltimate/AstrBot-Skill.git
git clone https://github.com/EterUltimate/astrbot-mcp.git
- 安装依赖：
cd astrbot-mcp
pip install -r requirements.txt
- 按需修改
config.yaml中的路径配置（默认会自动找到相邻的 AstrBot-Skill 仓库）。
运行
python server.py
配置说明
config.yaml 关键配置项：
| 字段 | 说明 | 默认值 |
|---|---|---|
docs.base_path |
文档引用目录路径 | ../AstrBot-Skill/skill-astrbot-dev/references |
hooks.generator_script |
Hook 清单生成脚本路径 | ../AstrBot-Skill/scripts/generate_hook_inventory.py |
hooks.output_path |
Hook 清单输出路径 | ../AstrBot-Skill/skill-astrbot-dev/.tmp/hook_inventory |
server.transport |
传输方式 | stdio |
sse.host |
SSE 主机（transport=sse 时） | localhost |
sse.port |
SSE 端口 | 3000 |
路径支持相对路径（基于 config.yaml 所在目录）和绝对路径。
与 AstrBot-Skill 的关系
本仓库是 AstrBot-Skill 的 MCP 服务端拆分。文档内容存储在 AstrBot-Skill 仓库的 skill-astrbot-dev/references/ 目录中，本服务通过文件系统读取并提供 MCP 工具接口。
License
MIT
