Enjin API Tool MCP Server

Enjin API 工具 MCP 服务

此 MCP 服务支持与 Enjin Platform API 交互。

前置条件

• Node.js（v16 或更高版本）
• 任意支持 MCP 的 IDE
• Enjin Platform API 密钥

设置说明

1. 获取 Enjin Platform API 密钥

• 在 Enjin Platform 上创建账户。
• 生成 API 密钥。

2. 初始项目设置

安装依赖：

npm install

3. 配置环境变量

为本地开发创建 .env 文件（不要提交此文件），或在 IDE 的 MCP 服务配置中定义环境变量。

示例：

ENJIN_API_ENDPOINT=https://platform.canary.enjin.io/graphql
ENJIN_API_KEY=your-enjin-api-key

4. 配置支持 MCP 的 IDE

按照对应 IDE 的说明配置 MCP 服务。通常包括：

1. 添加新的服务配置。
2. 指定运行服务的命令（例如：node build/index.js）。
3. 设置环境变量（例如：ENJIN_API_KEY）。

请参阅 IDE 文档以获取详细说明。

可用工具

此服务目前提供以下工具：

create_collection

在 Enjin Platform 上创建新的 NFT 集合。需要以下参数：

• name：（字符串）集合名称。
• description：（字符串）集合描述。
• media：（字符串）集合媒体的 URL。

get_collection

从 Enjin Platform 获取集合。需要以下参数：

• collection_id：（字符串）集合 ID。

类型定义

// Example type definitions - adjust based on your API responses
interface EnjinApiError {
    status?: number;
    message: string;
    code?: string;
}

interface Collection {
    id: string;
    name: string;
    description: string;
    media: string;
    // ... other collection properties
}

错误处理

此服务会处理各种错误情况：

环境错误

• 缺少 ENJIN_API_KEY
• API 密钥无效

API 错误

• 速率限制
• 请求参数无效
• 内部服务错误

故障排除

常见问题

IDE 中未显示工具

• 检查 IDE 日志
• 确认已正确设置 ENJIN_API_KEY
• 确保服务正在运行

身份验证错误

• 确认 API 密钥有效
• 检查密钥是否具有必要的权限

查看日志

如需查看服务日志，请参阅 IDE 文档，了解如何查看 MCP 服务的日志。

环境变量

如果遇到环境变量错误，请确认：

• ENJIN_API_ENDPOINT：应为有效的 Enjin Platform API 端点
• ENJIN_API_KEY：应为有效的 Enjin Platform API 密钥

安全注意事项

• 妥善保管 API 密钥
• 不要将凭据提交到版本控制系统
• 使用环境变量存储敏感数据
• 定期轮换 API 密钥
• 在 Enjin Platform 中监控 API 使用情况