astrbotmcp 0.2.1__py3-none-any.whl → 0.2.3__py3-none-any.whl

astrbot_mcp/astrbot_client.py

@@ -281,6 +281,48 @@ class AstrBotClient:
         response = await self._request("GET", "/api/config/platform/list")
         return response.json()
 
+    async def get_abconf_list(self) -> Dict[str, Any]:
+        """Call /api/config/abconfs and return the parsed JSON."""
+        response = await self._request("GET", "/api/config/abconfs")
+        return response.json()
+
+    async def get_abconf(
+        self,
+        *,
+        conf_id: str | None = None,
+        system_config: bool = False,
+    ) -> Dict[str, Any]:
+        """
+        Call /api/config/abconf and return the parsed JSON.
+
+        Args:
+            conf_id: Config file id to fetch.
+            system_config: If True, fetch system default config (AstrBot side expects system_config=1).
+        """
+        params: Dict[str, Any] = {}
+        if system_config:
+            params["system_config"] = "1"
+        if conf_id is not None:
+            params["id"] = conf_id
+        response = await self._request("GET", "/api/config/abconf", params=params or None)
+        return response.json()
+
+    async def update_astrbot_config(
+        self,
+        *,
+        conf_id: str,
+        config: Dict[str, Any],
+    ) -> Dict[str, Any]:
+        """
+        Update AstrBot core config via /api/config/astrbot/update (auto save + hot reload on AstrBot side).
+        """
+        payload: Dict[str, Any] = {
+            "conf_id": conf_id,
+            "config": config,
+        }
+        response = await self._request("POST", "/api/config/astrbot/update", json_body=payload)
+        return response.json()
+
     # ---- Plugin / market APIs ----------------------------------------
 
     async def get_plugin_market_list(

astrbot_mcp/server.py

@@ -26,6 +26,10 @@ server.tool(
     name="get_platform_session_messages",
 )
 server.tool(astrbot_tools.browse_plugin_market, name="browse_plugin_market")
+server.tool(astrbot_tools.list_astrbot_config_files, name="list_astrbot_config_files")
+server.tool(astrbot_tools.inspect_astrbot_config, name="inspect_astrbot_config")
+server.tool(astrbot_tools.apply_astrbot_config_ops, name="apply_astrbot_config_ops")
+server.tool(astrbot_tools.search_astrbot_config_paths, name="search_astrbot_config_paths")
 
 
 @server.resource("astrbot://info")
@@ -44,6 +48,10 @@ def astrbot_info():
             "restart_astrbot",
             "get_platform_session_messages",
             "browse_plugin_market",
+            "list_astrbot_config_files",
+            "inspect_astrbot_config",
+            "apply_astrbot_config_ops",
+            "search_astrbot_config_paths",
         ],
     }
 

astrbot_mcp/tools.py

@@ -16,13 +16,17 @@ Example:
 """
 
 # 导入所有工具函数，保持向后兼容
-from .tools import (
+from . import (
     get_astrbot_logs,
     get_message_platforms,
     send_platform_message_direct,
     send_platform_message,
     restart_astrbot,
     get_platform_session_messages,
+    list_astrbot_config_files,
+    inspect_astrbot_config,
+    apply_astrbot_config_ops,
+    search_astrbot_config_paths,
     MessagePart,
 )
 
@@ -33,5 +37,9 @@ __all__ = [
     "send_platform_message",
     "restart_astrbot",
     "get_platform_session_messages",
+    "list_astrbot_config_files",
+    "inspect_astrbot_config",
+    "apply_astrbot_config_ops",
+    "search_astrbot_config_paths",
     "MessagePart",
 ]

astrbotmcp-0.2.3.dist-info/METADATA

@@ -0,0 +1,188 @@
+Metadata-Version: 2.4
+Name: astrbotmcp
+Version: 0.2.3
+Summary: Add your description here
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Requires-Dist: fastmcp>=2.13.3
+Requires-Dist: httpx>=0.28.1
+Dynamic: license-file
+
+## AstrBot MCP
+
+[![MCP Badge](https://lobehub.com/badge/mcp/xunxiing-astrbotmcp)](https://lobehub.com/mcp/xunxiing-astrbotmcp)
+
+> **AstrBot 无法通过 MCP 控制自身。本项目填补了这一空白。**
+
+### 警告与免责声明
+
+⚠️ **本项目提供的是运维级控制能力，使用时请注意：**
+
+1. **重启风险** - `restart_astrbot` 会中断所有正在进行的对话
+2. **权限管理** - 确保 MCP 客户端的访问权限受控
+3. **生产环境** - 建议仅在开发/测试环境使用控制面功能
+4. **数据安全** - 日志可能包含敏感信息，注意脱敏处理
+
+**本项目与 AstrBot 官方无直接关联，由社区独立维护。**
+
+---
+### 这个项目到底在干什么
+
+#### AstrBot 自身的 MCP 控制面
+
+通过 MCP tool 实现：
+
+- **重启 AstrBot Core** - 进程级控制，直接调用 `/api/stat/restart-core`
+- **运行状态监听** - 实时日志流、平台状态监控
+- **配置热加载** - 动态读取/修改配置
+- **发送信息** -自动化测试插件
+- **浏览插件市场**
+
+#### 为astrbot开发者提供AI AGENT时代调试插件的自动化工具
+
+---
+
+### 快速开始
+
+#### 安装
+
+```bash
+# 通过 PyPI 安装（推荐）
+pip install astrbotmcp
+
+# 或通过 uv
+uv add astrbotmcp
+```
+
+#### MCP 客户端配置
+
+在 Cursor、Cline、Claude Desktop 等支持 MCP 的客户端中配置：
+
+```json
+{
+  "mcpServers": {
+    "astrbot-mcp": {
+      "command": "uvx",
+      "args": [
+        "--from",
+        "astrbotmcp",
+        "astrbot-mcp"
+      ],
+      "env": {
+        "ASTRBOT_BASE_URL": "http://127.0.0.1:6185",
+        "ASTRBOT_TIMEOUT": "30",
+        "ASTRBOT_USERNAME": "your_username",
+        "ASTRBOT_PASSWORD": "your_password"
+      }
+    }
+  }
+}
+```
+
+#### 环境变量说明
+
+| 变量 | 说明 | 默认值 |
+|------|------|--------|
+| `ASTRBOT_BASE_URL` | AstrBot Dashboard 地址 | `http://127.0.0.1:6185` |
+| `ASTRBOT_TIMEOUT` | HTTP 请求超时时间 | `30` |
+| `ASTRBOT_USERNAME` | Dashboard 用户名 | - |
+| `ASTRBOT_PASSWORD` | Dashboard 密码 | - |
+| `ASTRBOT_LOG_LEVEL` | 日志级别 | `INFO` |
+
+---
+
+### 可用 MCP Tools
+
+#### 控制面工具
+
+- `restart_astrbot` - 重启 AstrBot Core
+- `get_astrbot_logs` - 获取实时/历史日志
+- `get_message_platforms` - 列出已配置的消息平台
+
+#### 配置工具
+
+- `list_astrbot_config_files` - 列出所有 AstrBot 配置文件（`/api/config/abconfs`）
+- `inspect_astrbot_config` - 分层查看 JSON 配置节点（key / array length / value）
+- `apply_astrbot_config_ops` - 批量 `set` / `add_key` / `append`，并自动保存 + 热重载（`/api/config/astrbot/update`）
+- `search_astrbot_config_paths` - 按 key（可选再按 value）搜索配置，返回匹配项的路径（不返回大段内容）
+
+#### 消息工具
+
+- `send_platform_message` - 通过 Web Chat API 发送消息链
+- `send_platform_message_direct` - 直接发送到平台（绕过 LLM）
+- `get_platform_session_messages` - 读取会话消息历史
+
+#### 插件市场
+
+- `browse_plugin_market` - 浏览插件市场（搜索/排序）
+
+---
+
+### 使用示例
+
+#### 在 Agent 中重启 AstrBot
+
+```python
+# Agent 可以直接调用
+restart_astrbot()
+```
+
+#### 监控 AstrBot 日志
+
+```python
+# 实时获取最新日志
+logs = get_astrbot_logs(wait_seconds=10)
+```
+
+#### 发送消息到指定平台
+
+```python
+# 发送带图片的消息链
+send_platform_message(
+    platform_id="webchat",
+    message="Hello from MCP",
+    images=["/path/to/image.png"]
+)
+```
+
+---
+
+### 技术架构
+
+```
+┌─────────────────┐      HTTP API      ┌──────────────────┐
+│   MCP Client    │───────────────────>│  astrbot-mcp     │
+│ (Cursor/Cline)  │   (MCP Protocol)   │  (FastMCP Server)│
+└─────────────────┘                    └────────┬─────────┘
+                                                │
+                                                │ HTTP
+                                                ↓
+┌─────────────────┐                    ┌──────────────────┐
+│   AstrBot Core  │<───────────────────│  AstrBot         │
+│   + Plugins     │   (Dashboard API)  │  Dashboard       │
+└─────────────────┘                    └──────────────────┘
+```
+
+---
+
+
+### 开发与贡献
+
+```bash
+# 克隆项目
+git clone https://github.com/yourusername/astrbot-mcp.git
+cd astrbot-mcp
+
+# 安装依赖
+uv sync
+
+# 本地运行
+uv run --project . astrbot-mcp
+```
+
+---
+
+### 许可证
+
+MIT License - 详见 [LICENSE](LICENSE.txt) 文件

astrbotmcp-0.2.3.dist-info/RECORD

@@ -0,0 +1,11 @@
+astrbot_mcp/__init__.py,sha256=nDTFGuA6IlvCywUVliWHmmFBkQQsnLVgnZDFYfdALbo,370
+astrbot_mcp/astrbot_client.py,sha256=Kvcsk4gQytjZDoxLAXE7S6cmZjHGHzeNopzYnSyz9H0,19734
+astrbot_mcp/config.py,sha256=C5F0pHVGZkmxCGMPU9ns0G4whiy-ZCqfnQwUFuNmsLY,2820
+astrbot_mcp/server.py,sha256=SJWvmr1Nr7A_n5K8FlPUShNOLfNJd95kZwZK9knrbXk,2376
+astrbot_mcp/tools.py,sha256=rBL89W_4B7djcuGwBekLp-6pqi8dbmic8P3LJUIForI,1261
+astrbotmcp-0.2.3.dist-info/licenses/LICENSE.txt,sha256=5AYBumh99nqD7WWRY18ySSOIUKrj3bkAhVAiY-k8ZRo,1061
+astrbotmcp-0.2.3.dist-info/METADATA,sha256=QaT7bN6KioAxmNd8p2n-ZTCOl3htCA79x-SjDUBh9co,5120
+astrbotmcp-0.2.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+astrbotmcp-0.2.3.dist-info/entry_points.txt,sha256=XmfseRwldB3CJKlViESKuZNmw37qV2B57to8EQqvd5Q,56
+astrbotmcp-0.2.3.dist-info/top_level.txt,sha256=yi4CO_u3RImIkeQ562K9EbEc0nnKVgHQupSZ_X1GEO0,12
+astrbotmcp-0.2.3.dist-info/RECORD,,

astrbotmcp-0.2.1.dist-info/METADATA

@@ -1,90 +0,0 @@
-Metadata-Version: 2.4
-Name: astrbotmcp
-Version: 0.2.1
-Summary: Add your description here
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE.txt
-Requires-Dist: fastmcp>=2.13.3
-Requires-Dist: httpx>=0.28.1
-Dynamic: license-file
-
-## AstrBot MCP Server
-
-[![MCP Badge](https://lobehub.com/badge/mcp/xunxiing-astrbotmcp)](https://lobehub.com/mcp/xunxiing-astrbotmcp)
-
-本项目是一个基于 FastMCP 的 AstrBot MCP 服务器，通过 HTTP 与已有的 AstrBot 实例交互。
-
-当前包含的 MCP 工具（tools）：
-- `get_astrbot_logs`：查看日志（历史/实时）
-- `get_message_platforms`：列出已配置平台
-- `send_platform_message` / `send_platform_message_direct`：发送消息链
-- `get_platform_session_messages`：读取会话消息历史
-- `restart_astrbot`：重启 AstrBot Core
-- `browse_plugin_market`：浏览插件市场（搜索/按更新时间排序）
-
-### 本地运行
-
-在项目根目录执行（需要安装 `uv`）：
-
-```bash
-uv sync
-uv run --project . astrbot-mcp
-```
-
-如果看到 FastMCP 的 banner，说明服务启动成功。
-
-### MCP 配置（使用 uv + console script）
-
-在支持 MCP 的客户端中，推荐使用如下配置来启动本服务（示例为 JSON）：
-
-```json
-{
-  "mcpServers": {
-    "astrbot-mcp": {
-      "command": "uvx",
-      "args": [
-        "--from",
-        "astrbotmcp",
-        "astrbot-mcp.exe"
-      ],
-      "env": {
-        "ASTRBOT_BASE_URL": "http://127.0.0.1:6185",
-        "ASTRBOT_TIMEOUT": "30",
-        "ASTRBOT_USERNAME": "your_username",
-        "ASTRBOT_PASSWORD": "your_password"
-      }
-    }
-  }
-}
-```
-
-```json{
-"mcpServers": {
-"astrbot-mcp": {
-"command": "uv",
-"args": [
-"run",
-"--project",
-"D:/程序/astrbotmcp",
-"python",
-"-m",
-"astrbot_mcp.server"
-],
-"env": {
-"ASTRBOT_BASE_URL": "http://127.0.0.1:6185",
-"ASTRBOT_TIMEOUT": "30",
-"ASTRBOT_USERNAME": "user",
-"ASTRBOT_PASSWORD": "password"
-}
-}
-}
-}
-```
-
-注意：
-
-- 使用 `uv` 而不是系统 `python`，避免跑到全局 Python 3.13 环境。
-- 使用 `--project /path/to/astrbotmcp` 指定项目路径。
-- 使用 `astrbot-mcp`（console script），它会调用 `astrbot_mcp.server:main`。
-- 请您务必配置pypl代理：setx UV_INDEX_URL https://pypi.tuna.tsinghua.edu.cn/simple

astrbotmcp-0.2.1.dist-info/RECORD

@@ -1,11 +0,0 @@
-astrbot_mcp/__init__.py,sha256=nDTFGuA6IlvCywUVliWHmmFBkQQsnLVgnZDFYfdALbo,370
-astrbot_mcp/astrbot_client.py,sha256=XvvLDhPZF-YakqhJqpbB-NP6ybFd3uwp3Qxnvums03I,18310
-astrbot_mcp/config.py,sha256=C5F0pHVGZkmxCGMPU9ns0G4whiy-ZCqfnQwUFuNmsLY,2820
-astrbot_mcp/server.py,sha256=CRB29LfrKGDHRk1Al-DI6l5oV3QV-2CTqnmTyrEDQk4,1870
-astrbot_mcp/tools.py,sha256=WpVNHmu6NzbLXgDmgZCBiNo9WY4BqLw4NqZeU_eNCSs,1014
-astrbotmcp-0.2.1.dist-info/licenses/LICENSE.txt,sha256=5AYBumh99nqD7WWRY18ySSOIUKrj3bkAhVAiY-k8ZRo,1061
-astrbotmcp-0.2.1.dist-info/METADATA,sha256=2kVmBYByN-rrDs4k5gKD7FMxCbEtRrY347aNZmhNQ1k,2265
-astrbotmcp-0.2.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-astrbotmcp-0.2.1.dist-info/entry_points.txt,sha256=XmfseRwldB3CJKlViESKuZNmw37qV2B57to8EQqvd5Q,56
-astrbotmcp-0.2.1.dist-info/top_level.txt,sha256=yi4CO_u3RImIkeQ562K9EbEc0nnKVgHQupSZ_X1GEO0,12
-astrbotmcp-0.2.1.dist-info/RECORD,,