MCP Solana Affiliate Server

基本能力

产品定位

MCP Solana Affiliate Server 是一个独立的 MCP 服务器，专注于管理 Solana ICO 项目的联盟计划，包括联盟注册、佣金跟踪和代理功能。

核心功能

• 联盟注册：提供 affiliate://register 资源，生成唯一的联盟 ID 和 Solana Blink URL。
• Blink URL 处理：生成的 Blink URL 指向服务器内部的 /affiliate_buy_tokens 端点。
• 代理功能：/affiliate_buy_tokens 端点作为代理，接收 Blink 请求，将购买请求转发到主 ICO 服务器的 Action API，并记录佣金。
• 持久化存储：联盟数据和佣金存储在 JSON 文件（affiliate_data.json）中。
• 完全独立：该服务器不依赖于主 mcp_solana_ico 服务器，仅使用其 Action API URL 构建购买交易。

适用场景

• Solana ICO 项目的联盟计划管理。
• 需要独立处理联盟注册和佣金跟踪的场景。
• 需要生成 Solana Blink URL 并处理相关请求的场景。

工具列表

• FastMCP：用于提供 affiliate://register 资源。
• Flask：用于处理 Blink 请求和佣金记录。
• Poetry：用于依赖管理和项目配置。

常见问题解答

• 如何配置主服务器 URL？：在 .env 文件中设置 MAIN_SERVER_URL 为主 ICO 服务器的 Action API URL。
• 如何启动服务器？：使用 poetry run python mcp_solana_affiliate/server.py 命令启动服务器。
• 如何存储联盟数据？：联盟数据存储在 affiliate_data.json 文件中。

使用教程

使用依赖

• Python 3.11+
• Poetry
• Flask

安装 Poetry（如果尚未安装）：

pip install poetry

安装教程

1. 克隆仓库：

git clone <repository_url>
cd mcp_solana_affiliate

1. 安装依赖：

poetry install

1. 配置 .env 文件： 在根目录创建 .env 文件，内容如下：

MAIN_SERVER_URL="http://localhost:5000"  # 主 ICO 服务器的 Action API URL

调试方式

1. 启动服务器：

poetry run python mcp_solana_affiliate/server.py

1. 注册联盟： 使用 MCP 客户端调用 affiliate://register 资源，生成 Solana Blink URL。

2. 通过 Blink URL 购买代币： 用户点击 Blink URL 后，请求将发送到 /affiliate_buy_tokens 端点，服务器会处理请求并记录佣金。

许可证

该项目遵循 MIT-0 开源许可条款，请参阅 MIT-0 了解完整条款。