astrbotmcp 0.1.0

Add your description here

AstrBot MCP Server

本项目是一个基于 FastMCP 的 AstrBot MCP 服务器，通过 HTTP 与已有的 AstrBot 实例交互。

本地运行

在项目根目录执行（需要安装 uv）：

uv sync
uv run --project . astrbot-mcp

如果看到 FastMCP 的 banner，说明服务启动成功。

MCP 配置（使用 uv + console script）

在支持 MCP 的客户端中，推荐使用如下配置来启动本服务（示例为 JSON）：

{
  "mcpServers": {
    "astrbot-mcp": {
      "command": "uv",
      "args": [
        "run",
        "--project",
        "/path/to/astrbotmcp",
        "astrbot-mcp"
      ],
      "env": {
        "ASTRBOT_BASE_URL": "http://127.0.0.1:6185",
        "ASTRBOT_TIMEOUT": "30",
        "ASTRBOT_DEFAULT_PROVIDER": "your-provider-id",
        "ASTRBOT_DEFAULT_MODEL": "your-model-id"
      }
    }
  }
}

注意：

• 使用 uv 而不是系统 python，避免跑到全局 Python 3.13 环境。
• 使用 --project /path/to/astrbotmcp 指定项目路径。
• 使用 astrbot-mcp（console script），它会调用 astrbot_mcp.server:main。