Odinfun Mcp

odinfun-mcp

odinfun-mcp 是一个基于 Model Context Protocol（MCP） 的 Odin.fun 服务实现。它提供 canister 资产管理和 OdinFun API 工具，适用于区块链资产管理和数据查询场景。

本文档还提供简体中文和繁體中文版本。

功能

• Canister 资产管理工具

  • 查询余额、提现、创建新代币
  • 使用 BTC 买入／卖出代币，按数量买入／卖出
  • 添加／移除流动性

• OdinFun API 工具

  • 用户身份认证、更改用户名、发布评论
  • 查询 Odin.fun 代币列表、市场数据、K 线、持有者、流动性、评论等
  • 查询用户资产、创建／收藏的代币、流动性、活动记录等

安装

npm install odinfun-mcp

使用

1. 构建项目

   npm run build
   

2. 启动服务

   服务支持三种启动模式：

   • stdio 模式（默认）——适用于 CLI 应用和集成：

     npm start
     # or
     node dist/server.js
     

     此模式使用 stdin/stdout 进行通信，适用于命令行工具，以及与支持基于 stdio 的 MCP 连接的应用集成。

   • HTTP+SSE 模式——适用于 Web 应用和现代客户端（添加 --sse 参数）：

     node dist/server.js --sse
     

     此模式会在端口 3000 上启动 HTTP 服务，并提供以下 SSE 端点：

     • /sse - SSE 连接端点
     • /messages?sessionId=<id>&mode=sse - 消息处理端点
     • / - 服务状态端点

   • HTTP+Streamable 模式——适用于需要流式响应的应用（添加 --streamable 参数）：

     node dist/server.js --streamable
     

     此模式会在端口 3000 上启动 HTTP 服务，并提供以下流式端点：

     • /stream - 流连接端点
     • /messages?sessionId=<id>&mode=streamable - 消息处理端点
     • / - 服务状态端点

   注意：SSE 和 Streamable 模式可以同时启用：

   node dist/server.js --sse --streamable
   

3. 与 MCP 项目集成
   你可以在自己的 MCP 服务项目中导入并注册这些工具，也可以直接运行此软件包提供的服务。

主要导出项和入口

• 入口文件：dist/server.js
• 类型声明：dist/server.d.ts

主要工具概览

canisterTools

• canister_getBalance：查询代币余额
• canister_withdraw：提现代币
• canister_createToken：创建新代币
• canister_buyTokenWithBtc / canister_sellTokenForBtc：使用 BTC 买入／卖出代币
• canister_buyTokenAmount / canister_sellTokenAmount：按数量买入／卖出代币
• canister_addLiquidity / canister_removeLiquidity：添加／移除流动性

odinFunTools

OdinFun API 工具现在按功能模块进行组织，便于使用并提升与 AI 的集成效果。所有工具名称均采用统一规范，并按如下方式分组：

系统工具

• odinapi_getPriceUnitInfo：获取 Odin.fun API 中有关价格单位的信息，帮助理解如何解读价格值
• odinapi_getFaqInfo：获取 Odin.fun 官方常见问题信息，包括代币定价、AMM、绑定曲线和平台功能的详细说明

认证工具

• odinapi_authIdentity：使用 ICP 身份（Ed25519KeyIdentity）进行认证
• odinapi_identity_postComment：发布代币评论

市场工具

• odinapi_market_token_getInfo：获取代币详细信息（价格、交易量、持有者等）
• odinapi_market_token_list：筛选并排序代币列表
• odinapi_market_price_getBTC：获取 BTC 当前的美元价格
• odinapi_market_price_getHistory：获取代币价格历史记录（K 线数据）
• odinapi_market_trade_list：获取代币的交易记录
• odinapi_market_liquidity_getInfo：获取代币的流动性信息
• odinapi_market_liquidity_getUserPositions：获取用户的流动性仓位
• odinapi_comment_getBTCPrice：获取 BTC 当前的美元价格
• odinapi_comment_getTokens：获取近期活跃的 Odin.fun 代币
• odinapi_comment_getTokensByHighestMarketcap：获取市值最高的 Odin.fun 代币
• odinapi_token_getTradesByTime：按时间范围获取代币交易记录
• odinapi_token_getTradesByUser：获取指定用户的代币交易记录

用户工具

• odinapi_user_profile_getInfo：获取用户资料信息
• odinapi_user_profile_list：列出用户（支持搜索）
• odinapi_user_assets_getBalances：获取用户所有代币余额
• odinapi_user_assets_getTokenBalance：获取指定代币的余额
• odinapi_user_assets_getCreatedTokens：获取用户创建的代币
• odinapi_user_activity_list：获取用户活动历史记录
• odinapi_user_favorite_list：获取用户收藏的代币
• odinapi_user_favorite_toggle：将代币添加到收藏夹或从中移除

社交工具

• odinapi_social_comment_list：获取代币的评论
• odinapi_social_comment_post：发布代币评论
• odinapi_social_activity_feed：获取所有代币的近期活动
• odinapi_social_activity_getTokenActivities：获取指定代币的活动

通用/实用工具

• odinapi_tools_price_convert：在 sats 和美元之间转换价格
• odinapi_tools_price_getBTC：获取 BTC 当前的美元价格
• odinapi_tools_search_global：搜索所有实体（代币、用户等）
• odinapi_tools_enhance_tokenData：补充代币数据，包括价格、流动性等
• odinapi_tools_enhance_userData：补充用户数据，包括余额、活动、收藏等

所有工具名称和参数现已统一规范，并在代码中记录。完整的参数详情和用法示例请参阅代码库。

许可证

MIT