Skip to main content
Glama

astrbot-mcp

AstrBot MCP Server — Provides tool interfaces related to AstrBot plugin development.

Features

  • get_doc: Retrieve AstrBot development documentation content

  • list_docs: List all available documentation

  • search_docs: Search documentation by keywords

  • get_hook_inventory: Retrieve the complete Hook inventory

Related MCP server: openai-agents-sdk-mcp

Installation

Prerequisites

  • Python 3.10+

  • AstrBot-Skill repository (provides documentation references)

Configuration

  1. Clone this repository and AstrBot-Skill into the same directory:

mkdir astrbot-workspace && cd astrbot-workspace
git clone https://github.com/EterUltimate/AstrBot-Skill.git
git clone https://github.com/EterUltimate/astrbot-mcp.git
  1. Install dependencies:

cd astrbot-mcp
pip install -r requirements.txt
  1. Modify the path configuration in config.yaml as needed (by default, it will automatically find the adjacent AstrBot-Skill repository).

Running

python server.py

Configuration Details

config.yaml key configuration items:

Field

Description

Default Value

docs.base_path

Documentation reference directory path

../AstrBot-Skill/skill-astrbot-dev/references

hooks.generator_script

Hook inventory generation script path

../AstrBot-Skill/scripts/generate_hook_inventory.py

hooks.output_path

Hook inventory output path

../AstrBot-Skill/skill-astrbot-dev/.tmp/hook_inventory

server.transport

Transport method

stdio

sse.host

SSE host (when transport=sse)

localhost

sse.port

SSE port

3000

Paths support both relative paths (based on the directory where config.yaml is located) and absolute paths.

Relationship with AstrBot-Skill

This repository is an MCP server extraction of AstrBot-Skill. Documentation content is stored in the skill-astrbot-dev/references/ directory of the AstrBot-Skill repository, and this service reads it via the file system to provide MCP tool interfaces.

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides documentation generation and analysis tools for AI agents, including JSDoc generation, README analysis, changelog generation, API documentation, and code comment analysis.
      40 npm
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides MCP tools to list and search OpenAI Agents SDK documentation, enabling LLMs to retrieve documentation topics and content via natural language queries.
      61 PyPI
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      Exposes the Dalamud plugin API documentation to AI assistants, enabling them to answer questions about services, types, and methods for writing FFXIV Dalamud plugins.
      11
      1
      -