MCP 插件用于 ElizaOS

MCP 插件为 ElizaOS 提供了与 Model Context Protocol (MCP) 的集成，允许代理通过 MCP 服务器扩展功能。

特性

• 支持多种 MCP 服务器
• 灵活的配置选项
• 安全的执行环境
• 整合 ElizaOS 生态系统

安装

依赖安装

npm install @elizaos/plugin-mcp

示例配置

{
  "name": "Developer Assistant",
  "plugins": ["@elizaos/plugin-mcp"],
  "settings": {
    "mcp": {
      "servers": {
        "github": {
          "command": "npx",
          "args": ["-y", "@modelcontextprotocol/server-github"]
        },
        "puppeteer": {
          "command": "npx",
          "args": ["-y", "@modelcontextprotocol/server-puppeteer"]
        }
      }
    }
  }
}

配置选项

MCP 服务器配置

示例

{
  "github": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-github"],
    "env": {
      "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
    }
  },
  "google-maps": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-google-maps"],
    "env": {
      "GOOGLE_MAPS_API_KEY": "<YOUR_API_KEY>"
    }
  }
}

安全注意事项

• 仅信任来源：确保所有 MCP 服务器都是可信赖的，避免潜在的安全风险。
• 环境隔离：在生产环境中使用 sandbox 隔离 MCP 执行环境。

故障排除

1. 检查 MCP 服务是否正常运行
2. 确保命令路径正确且可用
3. 查看日志文件获取详细错误信息
4. 确认插件已正确加载

贡献指南

如何贡献

1. Fork 仓库
2. 创建新分支：git checkout -b feature-branch-name
3. 提交更改并遵循 Conventional Commits 规范
4. 推送至自己的仓库并提交 Pull Request

提交规范

使用以下类型：

• feat: 新功能
• fix: 修复问题
• chore: 工具或构建流程变更
• docs: 文档更新
• refactor: 代码重构
• style: 格式化调整
• test: 添加测试

许可证

该插件采用与 ElizaOS 相同的许可。