Apillon MCP Server

Apillon MCP Server

欢迎来到 Apillon MCP Server 仓库。本项目使用模型上下文协议（MCP）实现了一个服务，为存储、托管和 NFT 功能提供模块。

模型上下文协议（MCP）简介

模型上下文协议（MCP）是一种开放协议，用于规范应用程序如何为大语言模型（LLM）提供上下文。可以将 MCP 看作 AI 应用的 USB-C 接口。USB-C 提供了连接设备与各种外围设备和配件的标准方式，MCP 则提供了连接 AI 模型与不同数据源和工具的标准方式。

MCP 可帮助你在 LLM 之上构建 Agent 和复杂工作流。LLM 经常需要与数据和工具集成，而 MCP 提供了：

• 不断扩展的预构建集成列表，LLM 可以直接接入。
• 在不同 LLM 提供商和供应商之间切换的灵活性。
• 在你的基础设施中保护数据的最佳实践。

如需了解更多信息，请访问模型上下文协议简介。

项目概览

本项目由 Apillon 开发，提供以下模块的服务实现：

存储模块

存储模块提供全面的文件管理功能：

• 创建和管理存储桶
• 上传文件和文件夹，并支持目录结构
• 列出和管理存储桶中的对象（文件和文件夹）
• 为内容寻址生成 IPFS 链接
• 管理用于持久命名的 IPNS 记录
• 删除文件和目录
• 跟踪文件状态和元数据

托管模块

托管模块支持部署 Web 应用：

• 创建和管理网站实例
• 从本地文件夹或缓冲区上传网站文件
• 部署到预发布和生产环境
• 监控部署状态
• 列出和管理部署
• 支持多个部署环境

NFT 模块

NFT 模块提供全面的 NFT 管理功能：

• 在多种链（EVM、Substrate、Unique）上创建 NFT 集合
• 配置集合参数（名称、符号、版税等）
• 向指定地址铸造 NFT
• 支持嵌套 NFT（可嵌套集合）
• 销毁/撤销 NFT（适用于可撤销集合）
• 转移集合所有权
• 监控交易状态
• 支持配置参数的空投

与 Claude 搭配使用

要将此 MCP 与 Claude LLM 搭配使用，请按以下步骤操作：

1. 安装 Claude for Desktop

2. 找到 Claude Desktop 配置文件

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

3. 添加配置

复制 claude_desktop_config.json 中的配置，并根据自己的参数进行调整。

⚠️ 重要： 请务必修改 API 密钥环境变量以及 filesystem MCP 的允许目录。

{
  "mcpServers": {
    "apillon-mcp-server": {
      "command": "npx",
      "args": ["-y", "@apillon/mcp-server"],
      "env": {
        "APILLON_API_KEY": "<APILLON_API_KEY>",
        "APILLON_API_SECRET": "<APILLON_API_SECRET>"
      }
    },
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/your-username/Desktop"
      ]
    }
  }
}

4. 重启 Claude for Desktop

完成这些更改后，请重启 Claude Desktop，使配置生效。 现在，你可以只通过文本聊天提示 Claude 执行任何可用操作。

本地开发

前提条件

• Node.js 22 或更高版本
• npm 11 或更高版本
• TypeScript
• Apillon API 密钥和密钥（可在 https://app.apillon.io 生成）

安装

克隆仓库并安装依赖：

git clone https://github.com/Apillon/mcp-server.git
cd mcp-server
npm install

修改本地 Claude Desktop 配置：

{
  "mcpServers": {
    "apillon-mcp-server": {
      "command": "tsx",
      "args": ["/full/path/to/index.ts"],
      "env": {
        "APILLON_API_KEY": "<APILLON_API_KEY>",
        "APILLON_API_SECRET": "<APILLON_API_SECRET>"
      }
    }
  }
}

运行服务

建议使用上述配置，通过 Claude Dekstop 测试服务。 或者，要在本地启动服务，请使用以下命令：

npm start

构建项目

要构建项目，请运行：

npm run build

贡献

欢迎为 Apillon MCP 服务贡献代码。请查看 issues，了解尚未解决的任务或错误。

许可证

本项目采用 MIT 许可证。

MCP Review

此 MCP 服务已通过 MCP review 认证。

访问我们的 MCP Review 页面。

联系方式

如需了解更多信息，请访问 Apillon 网站，或通过 GitHub issues 联系我们。