模型上下文协议服务器

一个用于与Ergs API交互的模型上下文协议(MCP)服务器,使AI助手和其他MCP客户端能够通过Ergs Web API搜索和浏览数据源。

  • by rubiojr
  • Go
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 rubiojr/ergs-mcp

使用说明

Ergs MCP 服务器

一个模型上下文协议(MCP)服务器,提供与(某系统或平台)交互的工具 尔格(能量单位) API 此服务器使AI助手和其他MCP客户端能够通过Ergs网络API搜索和浏览您的数据源。

先决条件

  1. **尔格(能量单位)**你需要有 热尔(能量单位) 已安装并配置了您的数据源
  2. Ergs 网络服务器Ergs 网络服务器必须正在运行(默认: http://localhost:8080)
  3. **走(或“去”)**使用 Go 1.21 或更高版本来构建 MCP 服务器

安装

从源代码构建

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

使用Go安装(或:通过Go进行安装)

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

配置

MCP服务器连接到您的Ergs网络服务器。默认情况下,它期望Ergs正在以下地址运行: http://localhost:8080。

环境变量

  • ERGS_URL您的Ergs网络服务器的基础URL(默认: http://localhost:8080)

示例

# Use default Ergs URL (localhost:8080)
./ergs-mcp

# Connect to custom Ergs instance
ERGS_URL=http://ergs.example.com:3000 ./ergs-mcp

使用方法

启动Ergs网络服务器

首先,确保您的Ergs网络服务器正在运行:

ergs web --port 8080

运行MCP服务器

启动MCP服务器:

./ergs-mcp

服务器将使用MCP协议通过标准输入输出(stdio)进行通信。

MCP客户端配置

Claude Desktop(可译为“Claude桌面版”)

添加到您的Claude桌面配置中(~/Library/Application Support/Claude/claude_desktop_config.json (在 macOS 上):

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

Zed 编辑器

添加到您的 Zed 设置文件中(~/.config/zed/settings.json 在Linux上, ~/Library/Application Support/Zed/settings.json (在 macOS 上):

{
  "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服务器:

# Start Ergs web server in one terminal
ergs web --port 8080

# Run the MCP server in another terminal
./ergs-mcp

许可证

MIT 许可证 - 有关更多详细信息,请参阅 Ergs 项目。

链接