Eliza Plugin MCP

🚀 MCP 插件用於 ElizaOS

MCP 插件為 ElizaOS 提供了與 Model Context Protocol (MCP) 的集成能力，藉助此插件，代理能夠通過 MCP 服務器擴展自身功能，為系統帶來更豐富的應用場景和更強的實用性。

🚀 快速開始

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 相同的許可。