1MCP Server

--- title: MCP 内部工具参考 description: 1MCP 内部工具的完整参考文档 - 用于服务器发现、安装和管理的 MCP 协议工具 head: - ['meta', { name: 'keywords', content: 'MCP 内部工具,协议工具,AI 助手,服务器管理,自动化' }] - ['meta', { property: 'og:title', content: 'MCP 内部工具参考 - 1MCP' }] - ['meta', { property: 'og:description', content: '1MCP 内部工具的完整参考文档，用于 AI 助手的程序化服务器管理' }] --- # MCP 内部工具 MCP 内部工具是通过 Model Context Protocol 暴露给 AI 助手的工具，使其能够以编程方式发现、安装、管理和与 MCP 服务器交互。这些工具通过 MCP 协议提供，为服务器生命周期管理提供全面的自动化能力。 与供人类使用的 CLI 命令不同，内部工具专为 AI 助手集成和自动化工作流设计。 ## 概述 内部工具按功能领域分为三类： - **[发现工具](./internal-tools/discovery)** - 搜索注册表并发现 MCP 服务器 - **[安装工具](./internal-tools/installation)** - 安装、更新和移除 MCP 服务器 - **[管理工具](./internal-tools/management)** - 控制服务器操作状态和配置 ## 工具类别 ### 发现工具 使 AI 助手能够从各种注册表和来源搜索和发现 MCP 服务器。 - **`mcp_search`** - 在 MCP 注册表中搜索服务器 - **`mcp_registry_status`** - 检查注册表可用性和健康状况 - **`mcp_registry_info`** - 获取详细的注册表信息 - **`mcp_registry_list`** - 列出可用的注册表 - **`mcp_info`** - 获取详细的服务器信息 ### 安装工具 提供完整的 MCP 服务器生命周期管理： - **`mcp_install`** - 从注册表或自定义源安装 MCP 服务器 - **`mcp_uninstall`** - 移除 MCP 服务器，支持备份和回滚 - **`mcp_update`** - 将 MCP 服务器更新到最新版本或指定版本 ### 管理工具 提供对 MCP 服务器的操作控制： - **`mcp_enable`** - 启用已禁用的 MCP 服务器 - **`mcp_disable`** - 禁用 MCP 服务器而不移除 - **`mcp_list`** - 列出 MCP 服务器，支持过滤和状态信息 - **`mcp_status`** - 获取详细的服务器状态和健康信息 - **`mcp_reload`** - 重新加载服务器配置或重启服务器 - **`mcp_edit`** - 编辑 MCP 服务器配置 ## 示例用法 ### AI 助手工作流程 以下是 AI 助手如何使用这些内部工具来帮助用户： #### 示例 1：设置开发环境 ```json // 用户："我需要使用 PostgreSQL 数据库和 Git 仓库" [ { "tool": "mcp_search", "arguments": { "query": "postgresql database" } }, { "tool": "mcp_search", "arguments": { "query": "git repository" } }, { "tool": "mcp_install", "arguments": { "serverName": "postgres", "version": "2.0.1" } }, { "tool": "mcp_install", "arguments": { "serverName": "git", "version": "3.1.0" } }, { "tool": "mcp_list", "arguments": { "filter": "enabled" } } ] ``` #### 示例 2：服务器健康监控 ```json // AI 助手执行例行健康检查 [ { "tool": "mcp_list", "arguments": {} }, { "tool": "mcp_status", "arguments": { "serverName": "filesystem" } }, { "tool": "mcp_registry_status", "arguments": {} } ] ``` ### 程序化集成 #### 示例 3：CI/CD 流水线集成 ```bash # 使用 1MCP 内部工具通过 API 的部署脚本 #!/bin/bash # 为项目安装所需的 MCP 服务器 echo "正在安装 MCP 服务器..." curl -X POST http://localhost:3050/mcp \ -H "Content-Type: application/json" \ -d '{ "tool": "mcp_install", "arguments": { "serverName": "project-dependencies", "version": "latest" } }' # 验证安装 curl -X POST http://localhost:3050/mcp \ -H "Content-Type: application/json" \ -d '{ "tool": "mcp_list", "arguments": { "filter": "enabled" } }' ``` #### 示例 4：基础设施即代码 ```json { "mcp_servers": [ { "tool": "mcp_install", "arguments": { "serverName": "redis-cache", "version": "1.2.1", "config": { "host": "localhost", "port": 6379 } } }, { "tool": "mcp_install", "arguments": { "serverName": "file-storage", "version": "2.0.0", "config": { "rootPath": "/data/storage" } } } ] } ``` ## 使用场景 ### AI 助手自动化 AI 助手可以使用这些工具自动： - **发现相关服务器** 用于特定任务或领域 - **安装所需服务器** 基于用户需求或项目要求 - **管理服务器生命周期** 包括更新、健康监控和故障排除 - **编排复杂工作流** 涉及多个 MCP 服务器 ### 程序化服务器管理 开发者可以将这些工具集成到： - **CI/CD 流水线** 用于自动 MCP 服务器部署 - **基础设施即代码** 解决方案用于服务器配置 - **监控系统** 用于服务器健康和性能跟踪 - **自动化测试** 框架用于 MCP 服务器验证 ### 动态配置 工具支持动态服务器管理场景： - **按需安装服务器** 基于用户需求 - **优雅服务器更新** 支持回滚能力 - **基于健康的故障转移** 和恢复 - **环境间的配置同步** ## 关键特性 ### 全面的 API 覆盖 所有内部工具提供完整的输入/输出架构： - **类型化参数** 带有验证和约束 - **结构化输出** 保持一致的数据格式 - **错误处理** 提供详细的错误信息 - **进度反馈** 用于长时间运行的操作 ### 安全操作 内部工具优先考虑安全性和可靠性： - **备份和恢复** 支持破坏性操作 - **依赖验证** 防止破坏性更改 - **回滚支持** 用于失败的操作 - **操作前后健康检查** ### 集成友好 专为 AI 助手集成设计： - **语义化命名** 遵循 MCP 约定 - **描述性错误消息** 用于故障排除 - **进度指示器** 提供用户反馈 - **交叉引用** 相关操作 ## API 参考 详细的 API 文档包括架构、参数和示例： - **[发现工具](./internal-tools/discovery)** - 发现域工具和工作流 - **[安装工具](./internal-tools/installation)** - 安装域工具和安全功能 - **[管理工具](./internal-tools/management)** - 管理域工具和操作控制 ## 入门指南 AI 助手通常在连接到 1MCP 实例时通过 MCP 协议访问这些工具。工具根据服务器的能力和配置自动可用。 对于 CLI 用户，许多这些功能也可通过 [1MCP 命令](../commands/) 获得，提供用户友好的相同操作界面。 ## 另请参阅 - [服务器管理指南](../guide/essentials/server-management) - 手动服务器管理 - [MCP 命令参考](../commands/mcp/) - CLI 服务器管理命令