astrbotmcp 0.3.1__tar.gz → 0.4.1__tar.gz

{astrbotmcp-0.3.1/astrbotmcp.egg-info → astrbotmcp-0.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: astrbotmcp
-Version: 0.3.1
+Version: 0.4.1
 Summary: Add your description here
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
@@ -16,9 +16,7 @@ Dynamic: license-file
 
 [![MCP Badge](https://lobehub.com/badge/mcp/xunxiing-astrbotmcp)](https://lobehub.com/mcp/xunxiing-astrbotmcp)
 
-> **AstrBot 无法通过 MCP 控制自身。本项目填补了这一空白。**
-
-### 警告与免责声明
+> **AstrBot 无法通过 MCP 控制自身。本项目填补了这一空白,为Astrbot开发者提供AI AGENT时代调试插件的自动化工具**
 
 ⚠️ **本项目提供的是运维级控制能力，使用时请注意：**
 
@@ -27,33 +25,12 @@ Dynamic: license-file
 3. **生产环境** - 建议仅在开发/测试环境使用控制面功能
 4. **数据安全** - 日志可能包含敏感信息，注意脱敏处理
 
-**本项目与 AstrBot 官方无直接关联，由社区独立维护。**
-
----
-
-### 这个项目到底在干什么
-
-#### AstrBot 自身的 MCP 控制面
-
-通过 MCP tool 实现：
-
-- **重启 AstrBot Core** - 进程级控制，直接调用 `/api/stat/restart-core`
-- **运行状态监听** - 实时日志流、平台状态监控
-- **配置热加载** - 动态读取/修改配置
-- **发送信息** -自动化测试插件
-- **浏览插件市场**
-
-#### 为astrbot开发者提供AI AGENT时代调试插件的自动化工具
-
----
+### **本项目与 AstrBot 官方无直接关联，由社区独立维护。**
 
 ### 快速开始
 
 #### 安装
 
-<details>
-<summary>通过 PyPI 或 uv 安装</summary>
-
 ```bash
 # 通过 PyPI 安装（推荐）
 pip install astrbotmcp
@@ -62,7 +39,8 @@ pip install astrbotmcp
 uv add astrbotmcp
 ```
 
-安装完成后，您可以通过以下方式在 MCP 客户端中配置：
+<details>
+<summary>通过 PyPI 或 uv 安装</summary>
 
 ```json
 {
@@ -85,6 +63,8 @@ uv add astrbotmcp
 }
 ```
 
+安装完成后，您可以通过以下方式在 MCP 客户端中配置：
+
 </details>
 
 <details>
@@ -105,7 +85,8 @@ npm install -g astrbotmcp
     "astrbot-mcp": {
       "command": "npx",
       "args": [
-        "astrbotmcp"
+        "-y", 
+        "@xunxiing/astrbot-mcp@latest"
       ],
       "env": {
         "ASTRBOT_BASE_URL": "http://127.0.0.1:6185",
@@ -122,14 +103,15 @@ npm install -g astrbotmcp
 
 #### 环境变量说明
 
-| 变量 | 说明 | 默认值 |
-|------|------|--------|
-| `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` |
-| `ASTRBOTMCP_DISABLE_PROXY` | 是否禁用代理（防止本地请求被代理拦截） | `true` |
+| 变量                         | 说明                                                    | 默认值                    |
+| ---------------------------- | -------------------------------------------------------| ------------------------- |
+| `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`                  |
+| `ASTRBOTMCP_DISABLE_PROXY` | 是否禁用代理（防止本地请求被代理拦截）                  | `true`                  |
+| `ASTRBOTMCP_PLUGIN_PROXY`  | 插件 URL 安装默认代理前缀（`install_astrbot_plugin`） | `https://gh-proxy.com`  |
 
 #### 代理配置说明
 
@@ -138,10 +120,9 @@ npm install -g astrbotmcp
 **解决方案：**
 
 1. **默认行为**：AstrBot MCP 默认禁用代理（`ASTRBOTMCP_DISABLE_PROXY=true`），确保本地请求直接发送到 AstrBot。
-
 2. **如果需要使用代理**：设置 `ASTRBOTMCP_DISABLE_PROXY=false`，但请注意这可能导致本地 API 请求失败。
-
 3. **推荐配置**：对于本地 AstrBot 实例，始终禁用代理：
+
 ```json
 {
   "mcpServers": {
@@ -180,13 +161,18 @@ npm install -g astrbotmcp
 
 #### 消息工具
 
-- `send_platform_message` - 通过 Web Chat API 发送消息链
-- `send_platform_message_direct` - 直接发送到平台（绕过 LLM）
+- `send_platform_message` - 通过 Web Chat API 发送消息链（仅 WebUI；无需 `platform_id` / `target_id`）
 - `get_platform_session_messages` - 读取会话消息历史
 
 #### 插件市场
 
 - `browse_plugin_market` - 浏览插件市场（搜索/排序）
+- `install_astrbot_plugin` - Install plugin via URL or local zip path (proxy enabled by default)
+- `configure_astrbot_plugin_json` - Configure plugin JSON by reusing AstrBot config ops
+
+#### MCP 面板
+
+- `manage_mcp_config_panel` - Access MCP panel APIs (`list` / `add` / `update` / `delete` / `test`)
 
 ---
 
@@ -211,12 +197,18 @@ logs = get_astrbot_logs(wait_seconds=10)
 ```python
 # 发送带图片的消息链
 send_platform_message(
-    platform_id="webchat",
     message="Hello from MCP",
     images=["/path/to/image.png"]
 )
 ```
 
+```python
+# 插件命令请直接发送纯文本，不要命令前缀
+send_platform_message(
+    message="抽老婆帮助"
+)
+```
+
 ---
 
 ### 技术架构
@@ -256,4 +248,3 @@ uv run --project . astrbot-mcp
 ### 许可证
 
 MIT License - 详见 [LICENSE](LICENSE.txt) 文件。
-

{astrbotmcp-0.3.1 → astrbotmcp-0.4.1}/README.md

@@ -2,9 +2,7 @@
 
 [![MCP Badge](https://lobehub.com/badge/mcp/xunxiing-astrbotmcp)](https://lobehub.com/mcp/xunxiing-astrbotmcp)
 
-> **AstrBot 无法通过 MCP 控制自身。本项目填补了这一空白。**
-
-### 警告与免责声明
+> **AstrBot 无法通过 MCP 控制自身。本项目填补了这一空白,为Astrbot开发者提供AI AGENT时代调试插件的自动化工具**
 
 ⚠️ **本项目提供的是运维级控制能力，使用时请注意：**
 
@@ -13,33 +11,12 @@
 3. **生产环境** - 建议仅在开发/测试环境使用控制面功能
 4. **数据安全** - 日志可能包含敏感信息，注意脱敏处理
 
-**本项目与 AstrBot 官方无直接关联，由社区独立维护。**
-
----
-
-### 这个项目到底在干什么
-
-#### AstrBot 自身的 MCP 控制面
-
-通过 MCP tool 实现：
-
-- **重启 AstrBot Core** - 进程级控制，直接调用 `/api/stat/restart-core`
-- **运行状态监听** - 实时日志流、平台状态监控
-- **配置热加载** - 动态读取/修改配置
-- **发送信息** -自动化测试插件
-- **浏览插件市场**
-
-#### 为astrbot开发者提供AI AGENT时代调试插件的自动化工具
-
----
+### **本项目与 AstrBot 官方无直接关联，由社区独立维护。**
 
 ### 快速开始
 
 #### 安装
 
-<details>
-<summary>通过 PyPI 或 uv 安装</summary>
-
 ```bash
 # 通过 PyPI 安装（推荐）
 pip install astrbotmcp
@@ -48,7 +25,8 @@ pip install astrbotmcp
 uv add astrbotmcp
 ```
 
-安装完成后，您可以通过以下方式在 MCP 客户端中配置：
+<details>
+<summary>通过 PyPI 或 uv 安装</summary>
 
 ```json
 {
@@ -71,6 +49,8 @@ uv add astrbotmcp
 }
 ```
 
+安装完成后，您可以通过以下方式在 MCP 客户端中配置：
+
 </details>
 
 <details>
@@ -91,7 +71,8 @@ npm install -g astrbotmcp
     "astrbot-mcp": {
       "command": "npx",
       "args": [
-        "astrbotmcp"
+        "-y", 
+        "@xunxiing/astrbot-mcp@latest"
       ],
       "env": {
         "ASTRBOT_BASE_URL": "http://127.0.0.1:6185",
@@ -108,14 +89,15 @@ npm install -g astrbotmcp
 
 #### 环境变量说明
 
-| 变量 | 说明 | 默认值 |
-|------|------|--------|
-| `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` |
-| `ASTRBOTMCP_DISABLE_PROXY` | 是否禁用代理（防止本地请求被代理拦截） | `true` |
+| 变量                         | 说明                                                    | 默认值                    |
+| ---------------------------- | -------------------------------------------------------| ------------------------- |
+| `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`                  |
+| `ASTRBOTMCP_DISABLE_PROXY` | 是否禁用代理（防止本地请求被代理拦截）                  | `true`                  |
+| `ASTRBOTMCP_PLUGIN_PROXY`  | 插件 URL 安装默认代理前缀（`install_astrbot_plugin`） | `https://gh-proxy.com`  |
 
 #### 代理配置说明
 
@@ -124,10 +106,9 @@ npm install -g astrbotmcp
 **解决方案：**
 
 1. **默认行为**：AstrBot MCP 默认禁用代理（`ASTRBOTMCP_DISABLE_PROXY=true`），确保本地请求直接发送到 AstrBot。
-
 2. **如果需要使用代理**：设置 `ASTRBOTMCP_DISABLE_PROXY=false`，但请注意这可能导致本地 API 请求失败。
-
 3. **推荐配置**：对于本地 AstrBot 实例，始终禁用代理：
+
 ```json
 {
   "mcpServers": {
@@ -166,13 +147,18 @@ npm install -g astrbotmcp
 
 #### 消息工具
 
-- `send_platform_message` - 通过 Web Chat API 发送消息链
-- `send_platform_message_direct` - 直接发送到平台（绕过 LLM）
+- `send_platform_message` - 通过 Web Chat API 发送消息链（仅 WebUI；无需 `platform_id` / `target_id`）
 - `get_platform_session_messages` - 读取会话消息历史
 
 #### 插件市场
 
 - `browse_plugin_market` - 浏览插件市场（搜索/排序）
+- `install_astrbot_plugin` - Install plugin via URL or local zip path (proxy enabled by default)
+- `configure_astrbot_plugin_json` - Configure plugin JSON by reusing AstrBot config ops
+
+#### MCP 面板
+
+- `manage_mcp_config_panel` - Access MCP panel APIs (`list` / `add` / `update` / `delete` / `test`)
 
 ---
 
@@ -197,12 +183,18 @@ logs = get_astrbot_logs(wait_seconds=10)
 ```python
 # 发送带图片的消息链
 send_platform_message(
-    platform_id="webchat",
     message="Hello from MCP",
     images=["/path/to/image.png"]
 )
 ```
 
+```python
+# 插件命令请直接发送纯文本，不要命令前缀
+send_platform_message(
+    message="抽老婆帮助"
+)
+```
+
 ---
 
 ### 技术架构
@@ -242,4 +234,3 @@ uv run --project . astrbot-mcp
 ### 许可证
 
 MIT License - 详见 [LICENSE](LICENSE.txt) 文件。
-

{astrbotmcp-0.3.1 → astrbotmcp-0.4.1}/astrbot_mcp/astrbot_client.py

@@ -402,6 +402,38 @@ class AstrBotClient:
         response = await self._request("POST", "/api/config/astrbot/update", json_body=payload)
         return response.json()
 
+    async def get_plugin_config(
+        self,
+        *,
+        plugin_name: str,
+    ) -> Dict[str, Any]:
+        """
+        Get plugin config via /api/config/get?plugin_name=<name>.
+        """
+        response = await self._request(
+            "GET",
+            "/api/config/get",
+            params={"plugin_name": plugin_name},
+        )
+        return response.json()
+
+    async def update_plugin_config(
+        self,
+        *,
+        plugin_name: str,
+        config: Dict[str, Any],
+    ) -> Dict[str, Any]:
+        """
+        Update plugin config via /api/config/plugin/update?plugin_name=<name>.
+        """
+        response = await self._request(
+            "POST",
+            "/api/config/plugin/update",
+            params={"plugin_name": plugin_name},
+            json_body=config,
+        )
+        return response.json()
+
     async def list_session_rules(
         self,
         *,
@@ -458,6 +490,40 @@ class AstrBotClient:
         response = await self._request("GET", "/api/plugin/market_list", params=params or None)
         return response.json()
 
+    async def install_plugin_from_url(
+        self,
+        *,
+        url: str,
+        proxy: str | None = None,
+    ) -> Dict[str, Any]:
+        """
+        Install a plugin from repository URL via /api/plugin/install.
+        """
+        payload: Dict[str, Any] = {"url": url}
+        if proxy:
+            payload["proxy"] = proxy
+        response = await self._request("POST", "/api/plugin/install", json_body=payload)
+        return response.json()
+
+    async def install_plugin_from_file(
+        self,
+        file_path: str,
+    ) -> Dict[str, Any]:
+        """
+        Install a plugin from uploaded zip file via /api/plugin/install-upload.
+        """
+        send_name = os.path.basename(file_path)
+        with open(file_path, "rb") as f:
+            files = {
+                "file": (send_name, f, "application/zip"),
+            }
+            response = await self._request(
+                "POST",
+                "/api/plugin/install-upload",
+                files=files,
+            )
+            return response.json()
+
     # ---- Chat / platform session APIs --------------------------------
 
     async def create_platform_session(
@@ -692,3 +758,52 @@ class AstrBotClient:
         """
         response = await self._request("GET", "/api/stat/version")
         return response.json()
+
+    # ---- MCP panel APIs ----------------------------------------------
+
+    async def get_mcp_servers(self) -> Dict[str, Any]:
+        """
+        Get MCP server list from panel API /api/tools/mcp/servers.
+        """
+        response = await self._request("GET", "/api/tools/mcp/servers")
+        return response.json()
+
+    async def add_mcp_server(self, payload: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Add MCP server via panel API /api/tools/mcp/add.
+        """
+        response = await self._request("POST", "/api/tools/mcp/add", json_body=payload)
+        return response.json()
+
+    async def update_mcp_server(self, payload: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Update MCP server via panel API /api/tools/mcp/update.
+        """
+        response = await self._request("POST", "/api/tools/mcp/update", json_body=payload)
+        return response.json()
+
+    async def delete_mcp_server(self, *, name: str) -> Dict[str, Any]:
+        """
+        Delete MCP server via panel API /api/tools/mcp/delete.
+        """
+        response = await self._request(
+            "POST",
+            "/api/tools/mcp/delete",
+            json_body={"name": name},
+        )
+        return response.json()
+
+    async def test_mcp_server_connection(
+        self,
+        *,
+        mcp_server_config: Dict[str, Any],
+    ) -> Dict[str, Any]:
+        """
+        Test MCP connection via panel API /api/tools/mcp/test.
+        """
+        response = await self._request(
+            "POST",
+            "/api/tools/mcp/test",
+            json_body={"mcp_server_config": mcp_server_config},
+        )
+        return response.json()

{astrbotmcp-0.3.1 → astrbotmcp-0.4.1}/astrbot_mcp/config.py

@@ -15,7 +15,6 @@ class AstrBotSettings:
     default_provider: str | None = None
     default_model: str | None = None
     file_root: str | None = None
-    direct_media_mode: str | None = None
     disable_proxy: bool = True  # 默认禁用代理，防止本地请求被代理拦截
 
 
@@ -41,10 +40,6 @@ def get_settings() -> AstrBotSettings:
       - ASTRBOT_DEFAULT_PROVIDER: Default provider id to use for /api/chat/send.
       - ASTRBOT_DEFAULT_MODEL: Default model id to use for /api/chat/send.
       - ASTRBOTMCP_FILE_ROOT: Base directory for resolving relative local file_path.
-      - ASTRBOTMCP_DIRECT_MEDIA_MODE: How send_platform_message_direct handles local media:
-        - auto (default): try local path first, then fallback to upload+URL.
-        - local: always send local absolute paths to AstrBot platform adapters.
-        - upload: upload to AstrBot first and send an http(s) URL.
     """
     base_url = _get_env("ASTRBOT_BASE_URL")
     if not base_url:
@@ -69,9 +64,6 @@ def get_settings() -> AstrBotSettings:
     default_provider = _get_env("ASTRBOT_DEFAULT_PROVIDER")
     default_model = _get_env("ASTRBOT_DEFAULT_MODEL")
     file_root = _get_env("ASTRBOTMCP_FILE_ROOT") or _get_env("ASTRBOT_MCP_FILE_ROOT")
-    direct_media_mode = _get_env("ASTRBOTMCP_DIRECT_MEDIA_MODE") or _get_env(
-        "ASTRBOT_MCP_DIRECT_MEDIA_MODE"
-    )
 
     # 默认禁用代理，除非明确设置为false
     disable_proxy_str = _get_env("ASTRBOTMCP_DISABLE_PROXY")
@@ -87,6 +79,5 @@ def get_settings() -> AstrBotSettings:
         default_provider=default_provider,
         default_model=default_model,
         file_root=file_root,
-        direct_media_mode=direct_media_mode,
         disable_proxy=disable_proxy,
     )

{astrbotmcp-0.3.1 → astrbotmcp-0.4.1}/astrbot_mcp/server.py

@@ -15,6 +15,7 @@ server = FastMCP(
         "MCP server for interacting with an existing AstrBot instance. "
         "Provides tools to read logs, list configured message platforms, "
         "send message chains (including files) via the web chat API, "
+        "install/configure plugins, manage MCP panel config, "
         "restart AstrBot core, read platform session message history, "
         "and browse the AstrBot plugin market."
     ),
@@ -23,7 +24,6 @@ server = FastMCP(
 # Register tools with FastMCP
 server.tool(astrbot_tools.get_astrbot_logs, name="get_astrbot_logs")
 server.tool(astrbot_tools.get_message_platforms, name="get_message_platforms")
-server.tool(astrbot_tools.send_platform_message_direct, name="send_platform_message_direct")
 server.tool(astrbot_tools.send_platform_message, name="send_platform_message")
 server.tool(astrbot_tools.restart_astrbot, name="restart_astrbot")
 server.tool(
@@ -31,6 +31,12 @@ server.tool(
     name="get_platform_session_messages",
 )
 server.tool(astrbot_tools.browse_plugin_market, name="browse_plugin_market")
+server.tool(astrbot_tools.install_astrbot_plugin, name="install_astrbot_plugin")
+server.tool(
+    astrbot_tools.configure_astrbot_plugin_json,
+    name="configure_astrbot_plugin_json",
+)
+server.tool(astrbot_tools.manage_mcp_config_panel, name="manage_mcp_config_panel")
 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")
@@ -49,10 +55,12 @@ def astrbot_info():
             "get_astrbot_logs",
             "get_message_platforms",
             "send_platform_message",
-            "send_platform_message_direct",
             "restart_astrbot",
             "get_platform_session_messages",
             "browse_plugin_market",
+            "install_astrbot_plugin",
+            "configure_astrbot_plugin_json",
+            "manage_mcp_config_panel",
             "list_astrbot_config_files",
             "inspect_astrbot_config",
             "apply_astrbot_config_ops",

{astrbotmcp-0.3.1 → astrbotmcp-0.4.1}/astrbot_mcp/tools/__init__.py

@@ -20,11 +20,12 @@ from .control_tools import restart_astrbot
 from .log_tools import get_astrbot_logs
 from .message import (
     send_platform_message,
-    send_platform_message_direct,
 )
 from .platform_tools import get_message_platforms
 from .session_tools import get_platform_session_messages
 from .plugin_market_tools import browse_plugin_market
+from .plugin_admin_tools import install_astrbot_plugin, configure_astrbot_plugin_json
+from .mcp_panel_tools import manage_mcp_config_panel
 from .config_tools import (
     list_astrbot_config_files,
     inspect_astrbot_config,
@@ -40,7 +41,6 @@ from .helpers import (
     _as_file_uri,
     _attachment_download_url,
     _astrbot_connect_hint,
-    _direct_media_mode,
     _httpx_error_detail,
     _resolve_local_file_path,
 )
@@ -49,11 +49,13 @@ __all__ = [
     # 工具函数
     "get_astrbot_logs",
     "get_message_platforms",
-    "send_platform_message_direct",
     "send_platform_message",
     "restart_astrbot",
     "get_platform_session_messages",
     "browse_plugin_market",
+    "install_astrbot_plugin",
+    "configure_astrbot_plugin_json",
+    "manage_mcp_config_panel",
     "list_astrbot_config_files",
     "inspect_astrbot_config",
     "apply_astrbot_config_ops",
@@ -67,6 +69,5 @@ __all__ = [
     "_attachment_download_url",
     "_astrbot_connect_hint",
     "_httpx_error_detail",
-    "_direct_media_mode",
     "_as_file_uri",
 ]