🚀 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 许可证。