Ergs MCP

🚀 Ergs MCP 服務器

Ergs MCP 服務器是一個模型上下文協議（MCP）服務器，它提供了與 Ergs API 進行交互的工具。該服務器使 AI 助手和其他 MCP 客戶端能夠通過 Ergs 網絡 API 搜索和瀏覽你的數據源。

🚀 快速開始

使用 Ergs MCP 服務器前，你需要完成一些準備工作，並進行安裝和配置。

✨ 主要特性

• 提供與 Ergs API 交互的工具，讓 AI 助手和 MCP 客戶端能搜索和瀏覽數據源。
• 支持從源碼構建和使用 Go Install 進行安裝。
• 可通過環境變量配置連接的 Ergs 網絡服務器。

📦 安裝指南

從源碼構建

git clone https://github.com/rubiojr/ergs-mcp
cd ergs-mcp
go build -o ergs-mcp

使用 Go Install

go install github.com/rubiojr/ergs-mcp@latest

💻 使用示例

基礎用法

啟動 Ergs 網絡服務器

首先，確保你的 Ergs 網絡服務器正在運行：

ergs web --port 8080

運行 MCP 服務器

啟動 MCP 服務器：

./ergs-mcp

服務器將使用 MCP 協議通過標準輸入輸出進行通信。

MCP 客戶端配置

Claude Desktop

在你的 Claude Desktop 配置文件（macOS 上為 ~/Library/Application Support/Claude/claude_desktop_config.json）中添加以下內容：

{
  "mcpServers": {
    "ergs": {
      "command": "/path/to/ergs-mcp",
      "env": {
        "ERGS_URL": "http://localhost:8080"
      }
    }
  }
}

Zed Editor

在你的 Zed 設置文件（Linux 上為 ~/.config/zed/settings.json，macOS 上為 ~/Library/Application Support/Zed/settings.json）中添加以下內容：

{
  "context_servers": {
    "ergs": {
      "command": {
        "path": "/absolute/path/to/ergs-mcp",
        "args": [],
        "env": {
          "ERGS_URL": "http://localhost:8080"
        }
      }
    }
  }
}

請確保將 /absolute/path/to/ergs-mcp 替換為你實際構建的二進制文件的路徑。

其他 MCP 客戶端

配置你的 MCP 客戶端以執行 ergs-mcp 二進制文件並通過標準輸入輸出進行通信。

高級用法

構建

go build -o ergs-mcp

測試

確保 Ergs 網絡服務器正在運行，然後測試 MCP 服務器：

# 在一個終端中啟動 Ergs 網絡服務器
ergs web --port 8080

# 在另一個終端中運行 MCP 服務器
./ergs-mcp

📚 詳細文檔

配置

MCP 服務器連接到你的 Ergs 網絡服務器。默認情況下，它期望 Ergs 在 http://localhost:8080 上運行。

環境變量

• ERGS_URL：你的 Ergs 網絡服務器的基本 URL（默認：http://localhost:8080）

示例

# 使用默認的 Ergs URL（localhost:8080）
./ergs-mcp

# 連接到自定義的 Ergs 實例
ERGS_URL=http://ergs.example.com:3000 ./ergs-mcp

📄 許可證

本項目採用 MIT 許可證，更多詳細信息請參閱 Ergs 項目。

🔗 相關鏈接

• Ergs - 主要的 Ergs 項目
• MCP Go SDK - 模型上下文協議的 Go SDK
• Model Context Protocol - MCP 規範