Gaia MCP 服务器

一个用于 ProtoGaia 的 MCP (模型上下文协议) 服务器实现，支持 stdio 和 SSE (服务器发送事件) 两种通信方式。

目录

• 简介
• 安装
• 使用
  • 使用 Stdio 方法
  • 使用 SSE 方法
• 理解 MCP
• API 接口
• 支持的工具
• 注意

简介

此软件包包含 ProtoGaia 的 MCP 服务器的 TypeScript 实现。它为 LLM (大型语言模型) 提供了一种使用模型上下文协议与外部工具和服务进行通信的标准化方式。

安装

您可以通过多种方式使用 Gaia MCP 服务器：

使用 npx (无需安装)

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

# 以 SSE 模式运行
npx @ather-mcp/gaia-mcp-server sse

# 以 stdio 模式运行
npx @ather-mcp/gaia-mcp-server stdio --api-key=your-api-key

全局安装

将软件包全局安装，以便从任何位置运行：

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

然后从任何终端运行它：

# 以 SSE 模式运行
gaia-mcp-server sse

# 以 stdio 模式运行
gaia-mcp-server stdio --api-key=your-api-key

使用

服务器可以在两种模式下运行：stdio 或 SSE。您可以使用命令行界面选择要运行的模式。

使用 Stdio 方法

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

要以 stdio 模式启动服务器：

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

# 使用全局安装的软件包
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 模式启动服务器：

# 使用 npx
npx @ather-mcp/gaia-mcp-server sse

# 使用全局安装的软件包
gaia-mcp-server sse

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

连接到 SSE 服务器

要建立 SSE 连接：

1. 使用您的 Gaia 帐户 API 密钥创建到 /sse 端点的 EventSource 连接。有关创建 API 密钥的更多信息，请访问 此处。
2. 通过 POST 请求将消息发送到 /messages 端点

客户端 JavaScript 示例：

// 建立 SSE 连接
const eventSource = new EventSource('http://localhost:3000/sse?apiKey=your-gaia-account-api-key');
const sessionId = ''; // 将从第一条消息中填充

// 监听消息
eventSource.onmessage = event => {
  const data = JSON.parse(event.data);

  // 从第一条消息中存储会话 ID
  if (data.sessionId && !sessionId) {
    sessionId = data.sessionId;
  }

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

// 发送消息
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

模型上下文协议 (MCP) 是一种标准化的通信协议，使 LLM 能够与外部工具和服务进行交互。 更多信息可以在 modelcontextprotocol.io 找到。

关键 MCP 概念：

• 消息: 协议中的基本通信单元
• 工具: 可以由模型调用的函数
• 传输层: 通信方法 (stdio, SSE 等)
• 会话: 模型和服务器之间的有状态交互

此服务器实现使用 @modelcontextprotocol/sdk 软件包来处理协议细节。

API 接口

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

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

支持的工具

Gaia MCP 服务器提供多种 AI 图像生成和操作工具，可以由 LLM 调用：

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

每个工具都在 MCP 服务器中注册，并且可以根据模型上下文协议标准进行调用。

许可

Apache License 2.0

注意

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