Gaia MCP Server

Gaia MCP Server

⚠️ DEPRECATED

此代码仓库已弃用，不再积极维护。请改用新的 Go 实现：

👉 github.com/SipherAGI/gaia-mcp-go

Go 实现性能更好、安装更简单，并且仍在积极维护。

一个用于 ProtoGaia 的 MCP（Model Context Protocol）服务实现，支持 stdio 和 SSE（Server-Sent Events）两种通信方式。

目录

• 简介
• 安装
• 用法
  • 与 Claude Desktop 集成
  • 使用 Stdio 方式
  • 使用 SSE 方式
• 了解 MCP
• API 端点
• 支持的工具
• 注意事项

简介

此软件包包含一个用于 ProtoGaia 的 MCP 服务 TypeScript 实现。它通过 Model Context Protocol，为大模型（大型语言模型）与外部工具和服务提供标准化的通信方式。

安装

你可以通过多种方式使用 Gaia MCP Server：

使用 npx（无需安装）

无需安装，直接使用 npx 运行服务：

# Run in SSE mode
npx @ather-mcp/gaia-mcp-server sse

# Run in stdio mode
npx @ather-mcp/gaia-mcp-server stdio --api-key=your-api-key

全局安装

全局安装软件包，即可从任意位置运行：

npm install -g @ather-mcp/gaia-mcp-server

然后在任意终端中运行：

# Run in SSE mode
gaia-mcp-server sse

# Run in stdio mode
gaia-mcp-server stdio --api-key=your-api-key

用法

服务可以通过两种模式运行：stdio 或 SSE。你可以使用命令行界面选择运行模式。

与 Claude Desktop 集成

你可以将 Gaia MCP Server 与 Claude Desktop 集成，直接在对话中生成图像：

1. 获取 Gaia API 密钥：

   • 登录 Gaia 网站
   • 点击个人头像，进入账户设置
   • 前往“Security”部分
   • 创建新的 API 密钥并复制

2. 配置 Claude Desktop：

   • 打开 Claude Desktop
   • 前往 Settings（Windows 上依次选择 File > Settings；Mac 上选择 Claude > Settings）
   • 点击“Developer”选项卡
   • 点击“Edit config”按钮
   • 将内容替换为以下任一配置：

   如果已全局安装软件包：

   {
     "mcpServers": {
       "gaia-mcp-server": {
         "command": "gaia-mcp-server",
         "args": ["stdio", "--api-key=YOUR_GAIA_API_KEY"]
       }
     }
   }
   

   如果你更愿意使用 npx（无需安装）：

   {
     "mcpServers": {
       "gaia-mcp-server": {
         "command": "npx",
         "args": ["gaia-mcp-server", "stdio", "--api-key=YOUR_GAIA_API_KEY"]
       }
     }
   }
   

   将 YOUR_GAIA_API_KEY 替换为你的实际 Gaia API 密钥。

3. 重启 Claude Desktop

4. 测试集成：

   • 开始新对话
   • 让 Claude 生成图像（例如：“生成一张山间日落的图像”）
   • 你应该会在对话中看到生成的图像

如需更详细的说明和故障排查，请参阅 Claude Desktop 集成指南。

使用 Stdio 方式

stdio 方式适用于通过标准输入/输出流与服务直接通信，通常用于与 CLI 工具集成或本地开发。

要以 stdio 模式启动服务：

# Using npx
npx @ather-mcp/gaia-mcp-server stdio --api-key=your-api-key

# Using globally installed package
gaia-mcp-server stdio --api-key=your-api-key

你还可以指定自定义 API URL：

npx @ather-mcp/gaia-mcp-server stdio --api-key=your-api-key --api-url=https://your-custom-api-url

使用 stdio 方式时，客户端通过 stdin/stdout 按照 MCP 协议格式与服务通信。

通过 stdio 发送消息的示例：

{ "type": "message", "data": { "content": "Your message content here" } }

使用 SSE 方式

SSE 方式支持通过 HTTP 进行服务器发送事件通信，适用于 Web 应用。

要以 SSE 模式启动服务：

# Using npx
npx @ather-mcp/gaia-mcp-server sse

# Using globally installed package
gaia-mcp-server sse

服务将在 .env 文件指定的端口上启动（默认值：3000）。

连接到 SSE 服务

要建立 SSE 连接：

1. 使用 Gaia 账户的 API 密钥，为 /sse 端点创建 EventSource 连接。有关创建 API 密钥的更多信息，请参阅此处。
2. 通过 POST 请求向 /messages 端点发送消息

客户端 JavaScript 示例：

// Establish SSE connection
const eventSource = new EventSource('http://localhost:3000/sse?apiKey=your-gaia-account-api-key');
const sessionId = ''; // Will be populated from the first message

// Listen for messages
eventSource.onmessage = event => {
  const data = JSON.parse(event.data);

  // Store session ID from first message
  if (data.sessionId && !sessionId) {
    sessionId = data.sessionId;
  }

  console.log('Received:', data);
};

// Send a message
async function sendMessage(content) {
  await fetch('http://localhost:3000/messages', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      sessionId,
      message: {
        type: 'message',
        data: { content },
      },
    }),
  });
}

了解 MCP

Model Context Protocol（MCP）是一种标准化通信协议，可让大模型与外部工具和服务交互。更多信息请参阅 modelcontextprotocol.io。

MCP 的关键概念：

• 消息：协议中的基本通信单位
• 工具：模型可以调用的函数
• 传输层：通信方式（stdio、SSE 等）
• 会话：模型与服务端之间的有状态交互

此服务端实现使用 @modelcontextprotocol/sdk 包处理协议细节。

API 端点

在 SSE 模式下运行时，可使用以下端点：

• GET /sse：建立 SSE 连接
• POST /messages：向服务端发送消息
• GET /health：健康检查端点
• GET /：服务端的基本信息

支持的工具

Gaia MCP Server 提供多种 AI 图像生成和处理工具，可由大模型调用：

• upload-image：从 URL 将图像上传到 Gaia 平台
• create-style：使用提供的图像在 Gaia 平台创建新风格
• generate-image：根据文本提示词使用 Protogaia 生成图像
• remix：为现有图像创建新的变体
• face-enhancer：增强现有图像中的面部细节
• upscaler：提升图像分辨率质量

每个工具都已注册到 MCP 服务，可按照 Model Context Protocol 标准调用。

许可证

Apache License 2.0

注意

• 要使用生成式图像功能，用户必须拥有 GAIA 积分。你可以在此查看剩余积分并购买更多积分。