MCP Server for Agent8

Agent8 的 MCP 服务器

一个实现模型上下文协议 (MCP) 的服务器，用于支持 Agent8 SDK 开发。使用 TypeScript 和 pnpm 开发，支持 stdio、SSE 和 streamable-http 传输。

特征

该 Agent8 MCP 服务器实现了以下 MCP 规范功能：

提示

• Agent8 SDK 的系统提示：通过system-prompt-for-agent8-sdk提示模板为 Agent8 SDK 开发提供优化指南。

工具

• 代码示例搜索：使用search_code_examples工具从矢量数据库中检索相关的 Agent8 游戏开发代码示例。
• 游戏资源搜索：通过search_game_resources工具使用语义相似性匹配来搜索游戏开发资产（精灵、动画、声音等）。
• 资产生成：用于游戏资产创建的综合工具集：
  • 图像：使用image_asset_generate工具生成 2D 游戏资产
  • 电影：使用cinematic_asset_generate工具创建电影序列
  • 音频：使用music_generate和sfx_generate工具生成音乐曲目和音效
  • 天空盒：使用skybox_generate工具创建 360° 环境背景
  • 支持工具：状态检查、结果检索和异步生成的等待实用程序

安装

使用 Docker

您可以通过多种方式使用 Docker 运行此应用程序：

选项 1：从 GitHub Container Registry 拉取（推荐）

选项 2：本地构建

Docker环境配置

使用Docker运行时配置环境变量有三种方式：

1. 使用--env-file （推荐）：
   # Create and configure your .env file first cp .env.example .env nano .env # Run with .env file docker run -p 3000:3000 --env-file .env agent8-mcp-server
2. 使用单独的-e标志：
   docker run -p 3000:3000 \ -e SUPABASE_URL=your_supabase_url \ -e SUPABASE_SERVICE_ROLE_KEY=your_service_role_key \ -e OPENAI_API_KEY=your_openai_api_key \ -e MCP_TRANSPORT=sse \ -e PORT=3000 \ -e LOG_LEVEL=info \ agent8-mcp-server
3. 使用 Docker Compose（用于开发/生产设置）：该项目包含一个预先配置的docker-compose.yml文件，其中包含：
   • 从 .env 配置自动映射端口
   • 环境变量加载
   • 用于数据持久化的卷挂载
   • 容器自动重启策略
   • 健康检查配置

   运行服务器：

   docker compose up

   要在分离模式下运行：

   docker compose up -d

所需的环境变量：

• SUPABASE_URL ：用于数据库连接的 Supabase URL
• SUPABASE_SERVICE_ROLE_KEY ：用于身份验证的 Supabase 服务角色密钥
• OPENAI_API_KEY ：用于 AI 功能的 OpenAI API 密钥

Dockerfile 使用多阶段构建过程来创建最小生产映像：

• 使用 Node.js 20 Alpine 作为基础镜像，以减小体积
• 分离构建和运行时依赖关系
• 最终图像仅包含必要的文件
• 默认暴露端口 3000

用法

命令行选项

支持的选项：

• --debug ：启用调试模式
• --transport <type> ：传输类型（stdio、sse 或 streamable-http），默认值：stdio
• --port <number> ：用于 SSE 或 HTTP 传输的端口，默认值：3000
• --log-destination <dest> ：日志目标（stdout、stderr、file、none）
• --log-file <path> ：日志文件的路径（当日志目标是文件时）
• --log-level <level> ：日志级别（debug、info、warn、error），默认值：info
• --env-file <path> ：.env 文件的路径

使用环境变量

服务器支持通过环境变量进行配置，可以直接设置，也可以通过.env文件设置。

1. 在项目根目录中创建一个.env文件（请参阅.env.example以供参考）：

2. 运行服务器（它会自动加载.env文件）：

3. 或者指定.env文件的自定义路径：

配置优先级

服务器在确定配置值时使用以下优先级顺序：

1. 命令行参数（最高优先级）
2. 环境变量（来自.env文件或系统环境）
3. 默认值（最低优先级）

这使您可以在.env文件中设置基线配置，同时在需要时通过命令行参数覆盖特定设置。

支持的环境变量

工具激活优先级：工具激活设置遵循以下优先级顺序：

1. 单独的工具设置（例如， ENABLE_CODE_EXAMPLE_SEARCH_TOOL ）
2. 资源类型设置（例如， ENABLE_IMAGE_GENERATION_TOOLS 、 ENABLE_CINEMATIC_GENERATION_TOOLS ）
3. 工具组设置（例如， ENABLE_VECTOR_SEARCH_TOOLS ， ENABLE_ASSET_GENERATE_TOOLS ）
4. 全局工具设置（ ENABLE_ALL_TOOLS ）

个人设置始终覆盖组设置，组设置则覆盖全局设置。明确设置个人设置后，其优先级高于其父级设置。

重要提示：如需仅启用特定工具，您应该将所有更高级别的设置设为false ，并仅启用您需要的特定工具。这种方法可以提供更一致且更可预测的配置。

例子：

使用 Stdio Transport

使用 SSE 传输

使用可流式传输的 HTTP 传输

调试模式

可用提示

• systemprompt-agent8-sdk

客户端集成

与 Claude Desktop 一起使用

1. 将以下内容添加到 Claude Desktop 配置文件（ claude_desktop_config.json ）中：

1. 重启Claude桌面

添加新提示

向src/prompts/provider.ts文件中的registerSamplePrompts方法添加新的提示。

执照

麻省理工学院