AstrBot MCP Server

用于连接远程 AstrBot 服务器的 MCP 服务器，支持查看日志和实时调试。

功能

✅ 获取 AstrBot 运行状态
✅ 查看日志（最近 N 行）
✅ 实时监控日志
✅ 重启 AstrBot 服务
✅ 查看配置文件
✅ 列出已安装插件
✅ 查看插件配置
✅ 执行远程命令
✅ 检查错误日志

安装

pip install -r requirements.txt

配置

设置环境变量：

# Windows PowerShell
$env:ASTRBOT_SSH_PASSWORD="你的SSH密码"
$env:ASTRBOT_PATH="~/astrbot"

# Linux/Mac
export ASTRBOT_SSH_PASSWORD="你的SSH密码"
export ASTRBOT_PATH="~/astrbot"

或者直接修改 server.py 中的 SERVER_CONFIG。

使用方法

1. 直接运行

python server.py

2. 配置 OpenCode 使用

在 OpenCode 配置文件中添加：

{
  "mcp": {
    "servers": {
      "astrbot": {
        "command": "python",
        "args": ["D:\\opencode\\随便玩玩\\astrbot-mcp\\server.py"],
        "env": {
          "ASTRBOT_SSH_PASSWORD": "你的SSH密码",
          "ASTRBOT_PATH": "~/astrbot"
        }
      }
    }
  }
}

可用工具

工具名称	描述
`astrbot_status`	获取 AstrBot 运行状态
`astrbot_logs`	获取最近 N 行日志
`astrbot_logs_realtime`	实时监控日志（持续 N 秒）
`astrbot_restart`	重启 AstrBot 服务
`astrbot_config`	查看配置文件
`astrbot_plugins`	列出已安装插件
`astrbot_plugin_config`	查看指定插件配置
`astrbot_execute`	执行远程命令
`astrbot_check_errors`	检查错误日志

示例

获取状态

{
  "name": "astrbot_status",
  "arguments": {}
}

查看日志

{
  "name": "astrbot_logs",
  "arguments": {
    "lines": 100,
    "filter": "error"
  }
}

实时监控

{
  "name": "astrbot_logs_realtime",
  "arguments": {
    "duration": 60,
    "filter": "mimo_search"
  }
}

查看插件配置

{
  "name": "astrbot_plugin_config",
  "arguments": {
    "plugin_name": "mimo_search"
  }
}

AstrBot MCP Server

AstrBot MCP Server

功能

安装

配置

使用方法

1. 直接运行

2. 配置 OpenCode 使用

可用工具

示例

获取状态

查看日志

实时监控

查看插件配置

Latest Blog Posts

MCP directory API