AI导哈

Telegram礼物市场分析服务

基于模型上下文协议（MCP）的服务器，为AI代理提供Telegram礼物市场的实时数据获取、用户库存分析和深度市场分析工具。

  • by GIFT-ASSET
  • Python
  • 本地部署
  • 8 星标
  • 更新于
在 GitHub 查看 GIFT-ASSET/giftasset_mcp

使用说明

🎁 电报礼品分析师|MCP服务器

用 电报礼品分析师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环境。

  1. 塑造形象：
    docker-compose build



2. **Configure your MCP Client** (e.g., add to `claude_desktop_config.json`):
```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
  1. 配置您的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命令）。

相关 MCP