🎁 电报礼品分析师|MCP服务器
 ](https://www.docker.com/)  
用 电报礼品分析师MCP服务器.
该服务器基于模型上下文协议（MCP）构建，充当到 api.giftasset.dev API它为人工智能代理（如Claude或定制LLM机器人）配备了一套全面的工具，用于获取实时市场数据、分析用户库存，并跟踪Telegram礼品市场的深度分析。
______________________________________________________________________
🛠️ 暴露的工具（MCP端点）
服务器公开了以下工具，允许AI代理动态获取和聚合Telegram礼品市场数据：
| 工具 | 描述 | 关键参数 |
|---|---|---|
get_gift_info | 获取特定礼品实例的高分辨率数据。 | slug *（例如，“plushpep-1”）* |
get_market_actions | 跟踪所有受支持市场的全球市场动态（购买、上市、状态变化）。 | page, mode, action_type, gift，价格过滤器 |
get_gifts_aggregator | 结合多个参数查询经过高度过滤的统一市场数据。 | page, name, model, symbol, backdrop，价格过滤器 |
get_unique_last_sales | 检索指定收藏的最新唯一销售额。 | collection_name, limit, model_name |
get_all_collections_last_sale | 收集所有收藏的所有供应商的绝对最新销售数据。 | *无* |
get_gifts_update_stat | 提供礼品改进和升级的每日统计跟踪。 | *无* |
get_ton_price | 获取TON（the Open Network）以美元计的当前汇率。 | *无* |
get_gifts_price_list | 返回所有市场（GetGems、MRKT、Portals、Tonnel）所有系列的当前底价。 | models, premarket |
get_gifts_price_list_history | 返回礼品收藏的历史价格数据（每小时24小时，每天7天）。 | collection_name |
get_gift_by_name | 按确切名称查找特定礼物（例如“EasterEgg-1”）。 | name |
get_gift_by_user | 扫描并返回指定Telegram用户的详细礼品清单。 | username, limit, offset |
get_all_collections_by_user | 使用筛选选项列出用户拥有的所有集合。 | username, telegram_id, include, exclude |
get_user_profile_price | 计算总个人资料估值，并列出带有市场数据的顶级礼物。 | username, telegram_id, limit, offset |
get_unique_gifts_price_list | 返回收藏礼品价格的详细信息。 | collection_name |
get_gifts_collections_emission | 追踪藏品中的独特礼品问题。 | *无* |
get_gifts_collections_marketcap | 计算礼品的总市值。 | *无* |
get_gifts_collections_health_index | 评估收集健康状况（流动性、单克隆抗体、鲸鱼）。 | *无* |
get_gifts_collections_greed_index | 跟踪贪婪指数指标（隐藏、升级、所有者）。 | *无* |
get_providers_volumes | 提供所有供应商的汇总销售量。 | *无* |
______________________________________________________________________
🚀 先决条件
- python 3.11或更高版本（或已安装Docker）。
- API密钥： 你需要一个有效的
GIFTASSET_API_KEY以连接到GiftAsset API。
> 🔑 在此处获取您的钥匙： @giftassetmcpobot
______________________________________________________________________
🔌 连接到AI代理
您可以将此服务器连接到任何兼容MCP的客户端（例如 克劳德桌面版 或 光标).API密钥必须通过 GIFTASSET_API_KEY 环境变量。
🐳 选项1：使用Docker（推荐）
Docker提供了最干净的集成，而不会污染您的本地Python环境。
- 塑造形象：
docker-compose build
2. **Configure your MCP Client** (e.g., add to `claude_desktop_config.json`):{ "mcpServers": { "telegram-gifts": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "GIFTASSET_API_KEY=your_api_key_here", "telegram-gifts-mcp" ] } } }
### 🐍 选项2：使用本地Python环境
如果你更喜欢通过Python在本地运行它，请按照以下步骤操作：
1. **设置环境：**
python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate pip install -r requirements.txt
2. **配置您的MCP客户端** （例如，添加到 `claude_desktop_config.json`):
*注意：您必须使用 **绝对路径** 对于Python二进制文件和项目目录。*
{ "mcpServers": { "telegram-gifts": { "command": "/absolute/path/to/your/venv/bin/python", "args": [ "-m", "src.server" ], "env": { "PYTHONPATH": "/absolute/path/to/giftasset_mcp", "GIFTASSET_API_KEY": "your_api_key_here" } } } }
______________________________________________________________________
## 💻 独立测试
想在将服务器连接到代理之前通过标准I/O直接测试服务器吗？
export GIFTASSET_API_KEY="your_api_key_here" python -m src.server
*（注意：服务器将在MCP stdio模式下启动，期望通过stdin/stdout获得JSON-RPC命令）。*