# mcp_admin MCP 管理工具手册

## 模板（概述）

### 一句话定位

- <该工具集用途，一句话描述>

### 工具清单

- <列出核心工具，或指向工具章节>

### 30 秒上手

1. <调用 ...>
2. <观察 ...>
3. <下一步 ...>

### 导航

- principles / tools / scenarios / errors

### 与其他工具集的边界

- <何时用本工具集、何时用相邻工具集>

mcp_admin 是 Dominds 的 **MCP 管理工具集**，用于管理 MCP（Model Context Protocol）连接和资源：

- **MCP 重启/启用**：启用并重启 MCP 服务
- **MCP 释放**：释放 MCP 租约
- **MCP 禁用**：禁用 MCP 服务，并保留 0 工具 toolset/手册可见性
- **环境变量**：读取、设置、删除本地环境变量

## 快速导航

| 主题                          | 描述                           |
| ----------------------------- | ------------------------------ |
| [principles](./principles.md) | 核心概念、连接管理、最佳实践   |
| [tools](./tools.md)           | 使用指导、边界说明与操作注意   |
| [scenarios](./scenarios.md)   | 常见使用场景与示例（复制即用） |
| [errors](./errors.md)         | 错误代码与解决方案             |

## 状态

- 状态：已实现
- 主要实现文件：
  - MCP 工具实现：`dominds/main/tools/mcp.ts`
  - 环境变量工具实现：`dominds/main/tools/env.ts`
  - toolset 元信息：`dominds/main/tools/builtins.ts`、`dominds/main/tools/registry.ts`

## 核心概念

### MCP（Model Context Protocol）

MCP 是用于连接外部服务和工具的协议，允许智能体调用外部工具和服务。

### MCP 租约

MCP 连接使用租约机制管理，确保资源合理分配和释放。
