## AstrBot MCP Server

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

### 本地运行

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

```bash
uv sync
uv run --project . astrbot-mcp
```

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

### MCP 配置（使用 uv + console script）

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

```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`。
