JinDaGe - mcp-agent8 MCP Details

article

README

🚀 MCP 服务器指南

MCP Server 提供了一系列实用工具，涵盖资产生成、天空盒生成、音频生成等功能。默认情况下，所有工具都会启用，同时支持通过环境变量对工具的启用状态进行灵活控制。

🚀 快速开始

按照以下步骤，你可以快速启动 MCP Server：

pnpm install
pnpm build
pnpm start

✨ 主要特性

提供多种实用工具，如资产生成、天空盒生成、音频生成等。
支持通过环境变量对工具启用状态进行控制。
具备多种传输类型和运行模式可供选择。

📦 安装指南

在项目根目录下，依次执行以下命令完成安装和构建：

pnpm install
pnpm build

💻 使用示例

基础用法

启动 MCP Server 的基础命令如下：

pnpm start

高级用法

配置环境变量

通过设置环境变量，可以对 MCP Server 的各项功能进行定制。以下是各环境变量的详细说明： | 变量名 | 作用 | 默认值 | |------------------|----------------------------------|--------| | MCP_TRANSPORT | 设置传输类型（stdio 或 SSE） | stdio | | PORT | 指定 SSE 传输的端口 | 3000 | | LOG_LEVEL | 设置日志级别（debug, info, warn, error） | info | | LOG_DESTINATION | 设置日志输出目的地（stdout, stderr, file, none） | 根据传输类型自动选择 | | LOG_FILE | 指定文件日志的存储路径 | 无 | | DEBUG | 启用调试模式（true/false） | false | | SUPABASE_URL | Supabase 数据库连接 URL | 必填 | | SUPABASE_KEY | Supabase 服务角色密钥 | 必填 | | OPENAI_API_KEY | OpenAI API 密钥 | 必填 | | BLOCKADE_LABS_API_KEY | Blockade Labs API 密钥（天空盒生成必备） | 必填 |

工具激活优先级

工具的激活优先级如下：

单个工具设置（如：ENABLE_CODE_EXAMPLE_SEARCH_TOOL）
工具组设置（如：ENABLE_VECTOR_SEARCH_TOOLS）
全局工具设置（ENABLE_ALL_TOOLS）

以下是一些具体的配置示例：

# 启用仅向量搜索工具
ENABLE_ALL_TOOLS=false
ENABLE_VECTOR_SEARCH_TOOLS=true

# 启用仅资产生成工具
ENABLE_ALL_TOOLS=false
ENABLE_ASSET_GENERATE_TOOLS=true

# 禁用特定工具的同时保持其他工具启用
ENABLE_ALL_TOOLS=true
ENABLE_CODE_EXAMPLE_SEARCH_TOOL=false

不同运行模式

使用 stdio 传输：

pnpm build
pnpm start --transport=stdio

使用 SSE 传输（默认端口：3000）：

pnpm build
pnpm start --transport=sse --port=3000

调试模式：

pnpm start --debug

集成到 Claude Desktop

将以下内容添加至 claude_desktop_config.json：

{
  "mcpServers": {
    "Agent8": {
      "command": "npx",
      "args": ["--yes", "agent8-mcp-server"]
    }
  }
}

然后重启 Claude Desktop。

📄 许可证

本项目采用 MIT 许可证。

mcp-agent8