MCP 集成
通过 Model Context Protocol (MCP) 服务器扩展 Alma 功能。
什么是 MCP？
MCP（Model Context Protocol）是一个开放协议，允许 AI 应用与外部服务和数据源交互。通过 MCP 服务器，Alma 可以：
- 访问第三方 API
- 连接数据库
- 与其他工具集成
安装 MCP 服务器
从市场
- 打开 设置 → MCP
- 浏览可用服务器
- 点击 安装
手动添加
- 打开 设置 → MCP
- 点击 添加服务器
- 配置服务器设置
配置
服务器类型
stdio：本地进程
json
{
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem"]
}SSE：远程服务器
json
{
"url": "https://example.com/mcp"
}环境变量
某些服务器需要 API 密钥或其他配置：
json
{
"env": {
"API_KEY": "your-key"
}
}使用 MCP 工具
MCP 工具与内置工具一样使用：
- 安装 MCP 服务器后，其工具自动可用
- 工具以
serverName__toolName格式显示 - AI 可以自动选择使用
流行的 MCP 服务器
| 服务器 | 功能 |
|---|---|
| filesystem | 文件系统访问 |
| github | GitHub API 集成 |
| postgres | PostgreSQL 数据库访问 |
| slack | Slack 消息发送 |
故障排除
服务器无法启动
- 检查命令和参数
- 验证依赖是否已安装
- 查看日志获取错误信息
工具不可用
- 确保服务器已启用
- 检查服务器是否成功连接
- 在工具选择器中启用 MCP 工具