区块链协议工具集

Basis MCP Server 是一个为 Basis 协议(基于 BNB 智能链)提供 205 种工具的综合服务,涵盖交易、代币创建、预测市场、质押、贷款等功能,可与 Claude Desktop 和任何 MCP 兼容客户端配合使用。

  • by Launch-On-Basis
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 Launch-On-Basis/MCP-TS

使用说明

基础MCP服务器

基础协议(在BNB智能链上)的205个工具——交易、代币创建、预测市场、质押、贷款、行权、订单簿、税收、社交、BTC/ETH/BNB/CAKE/DOGE上/下投注等。适用于Claude Desktop、Claude Code和任何兼容MCP的客户端。

SDK捆绑在里面,不需要单独安装。

需求

快速开始

1.克隆并安装

git clone https://github.com/Launch-On-Basis/MCP-TS.git
cd MCP-TS
npm install
npm run build

2.获取私钥

您需要一个BNB智能链(BSC)钱包私钥。如果你只是在测试,创建一个新的钱包,并通过水龙头申请测试USDB(有一个 claim_faucet 工具)。

3.添加到克劳德桌面

打开您的Claude桌面配置:

  • 雨衣: ~/Library/Application Support/Claude/claude_desktop_config.json
  • 窗户: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

将此添加到 "mcpServers" object(如果它不存在,则创建它):

{
  "mcpServers": {
    "basis": {
      "command": "node",
      "args": ["/full/path/to/MCP-TS/dist/index.js"],
      "env": {
        "BASIS_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY_HERE"
      }
    }
  }
}

重新启动克劳德桌面。你应该看到“基础”出现在 连接器 在侧边栏中。如果它显示为已连接,则可以继续。

4.试试看

打开新聊天并询问:

  • “我的余额是多少?”
  • “STASIS的价格是多少?”
  • “显示活跃的预测市场”
  • “使用Floor+机制创建一个名为DEMO的代币”

环境变量

变量 必填 描述
BASIS_PRIVATE_KEY 是 BNB智能链钱包私钥(前缀0x)
BASIS_API_KEY 否 Basis API密钥(以开头 bsk_).创建时显示一次——保存。如果省略,则在第一次运行时通过SIWE自动配置。如果服务器上已存在密钥,则后续运行时需要此项。

工具(205)

贸易(8)

工具 类型 描述
buy_token write 用美元购买代币。执行前预览。
sell_token write 以USDB的价格出售代币。首先检查余额。
get_price read 获取代币的当前美元价格。
get_token_price read 获取原始代币价格(储备比率)。
preview_trade read 预览买入/卖出而不执行。
leverage_buy write 打开杠杆头寸。首先进行模拟,需要确认。
close_leverage write 关闭/部分关闭杠杆头寸。
get_leverage_positions read 列出所有杠杆头寸。

代币创建(10)

工具 类型 描述
create_token write 创建新令牌。永远赚取所有交易的20%。接受图像URL或本地文件。
unfreeze_token write 开放冻结代币公开交易。不可逆转。
whitelist_wallets write 将钱包添加到冻结代币的白名单中。
get_token_state read 获取令牌状态(冻结、供应、价格)。
claim_rewards write 领取奖励阶段收益。
get_claimable_rewards read 查看可领取的奖励金额。
get_my_tokens read 列出您创建的令牌。
is_ecosystem_token read 检查地址是否为Basis令牌。
get_fee_amount read 获取代币创建费。
get_floor_price read 获取代币的底价。

预测市场(18)

工具 类型 描述
create_market write 使用元数据创建预测市场。接受图像URL或本地文件。
bet write 购买业绩股。无上限支付。
redeem_winnings write 从已解决的市场中领取奖金。
get_market_info read 市场数据+结果概率。
propose_outcome 写 提出获胜结果(5亿美元债券)。
dispute_outcome 对提议的结果提出异议。
vote_on_dispute wrote 在辩论环节投票。
finalize_market write 挑战期结束后,最终确定解决方案。
claim_bounty write 索赔解决程序赏金。
get_my_shares read 查看市场上持有的股票。
resolver_stake wrote 争议投票的质押/撤销质押。
get_market_resolution_status read 全分辨率管道状态。
get_bounty_pool read 市场赏金池金额。
get_general_pot read 市场总金额。
estimate_shares_out read 估计美元赌注的份额
get_potential_payout read 持有股票的潜在支出。
buy_orders_and_contract write 从订单簿+AMM中一次性购买
get_min_seed read 创建公共预测市场所需的最低美元种子。

打桩和保险库(7)

工具 类型 描述
stake_stasis 写 多步骤:购买STASIS,包装到wSTASIS,锁上。
unstake_stasis write 解锁、拆包,可选择出售给USDB。
vault_borrow wrote 以锁定的wSTASIS借入美元。
vault_repay wrote 偿还保险库贷款。
get_vault_status read 满库位置状态。
get_vault_loan read 活动保险库贷款的全部贷款详细信息。如果没有,则返回null。
extend_loan write 延长保险库或中心贷款。

贷款(9)

工具 类型 描述
take_loan wrote 任何代币贷款。无价格清算。
repay_loan wrote 偿还中心贷款。
get_loans read 列出活动贷款。
get_user_loan_details 阅读 特定贷款的链上详细信息。
get_user_loan_count read 钱包贷款计数。
increase_loan_collateral write 为现有贷款添加抵押品。
claim_liquidation wrote 从到期贷款中提取剩余抵押品。
claim_leverage_liquidation wrote 从清算杠杆头寸中提取美元余额(使用loanId)。
partial_loan_sell 写 部分出售中心贷款抵押品。

投资组合与数据(22)

工具 类型 描述
get_balances read 钱包余额(USDB、STASIS、wSTASIS、工厂代币)。
get_market_list read 列出预测市场。
get_token_list read 搜索/列出标记。
get_token_detail read 单个令牌的完整详细信息。
get_price_history 阅读 OHLC蜡烛。
get_trade_history read 最近的交易。
get_platform_stats read 平台脉冲统计数据。
get_my_stats 阅读 您的交易统计数据。
get_my_profile 阅读 你的等级、排名、连胜。
get_leaderboard 阅读 平台排行榜。
get_public_profile read 任何钱包的公共配置文件。
get_my_projects read 您创建的代币和市场。
get_my_referrals read 您的推荐数据。
get_my_daily_caps read 今天的上限填充率 pointCaps (交易、预测、创建者、头寸)和 countCaps (social_x,social_moltbook)。包含 resetsInSeconds.
get_my_orders 阅读 您的订单历史记录。分页的可选状态/市场/结果过滤器。
get_whitelist read 查看冻结令牌的白名单。
get_token_comments read 对令牌的评论。
get_loan_events read 贷款事件历史记录。
get_vault_events 阅读 保险库质押事件历史记录。
get_market_events read 预测市场事件历史。
get_market_liquidity read 市场流动性数据。
remove_whitelist write 从白名单中删除钱包。

代理身份(9)

工具 类型 描述
register_agent write 注册为链上的AI代理(ERC-8004)。用于恢复的可选tx_hash。
is_agent_registered read 检查钱包是否是注册代理。
list_agents read 列出已注册的AI代理。
lookup_agent 按钱包查找代理人。
get_agent_uri read 获取代理元数据URI
get_agent_wallet read 获取代理ID的钱包
get_agent_metadata read 按键获取代理元数据。
set_agent_uri write 更新代理元数据URI
get_agent_id_from_tx read 从注册tx哈希中恢复代理ID。

背心(18)

工具 类型 描述
create_gradual_vesting write 创建逐步行权计划。
create_cliff_vesting write 创建悬崖行权。
batch_create_gradual_vesting write 批量创建渐进式投资。
batch_create_cliff_vesting write 批量创建悬崖服饰。
claim_vesting_tokens write 声明已授予的代币。
take_loan_on_vesting 写 以行权为抵押借款。
repay_loan_on_vesting wrote 偿还行权贷款。
get_vesting_details read 有关行权时间表的详细信息。
get_vesting_details_batch read 多个投资的批次详细信息。
get_vesting_count read 总行权时间表。
get_claimable_vesting read 检查可索赔金额。
get_my_vestings 阅读 您的投资(作为受益人或创造者)。
get_token_vesting_ids read 为令牌授予ID。
change_vesting_beneficiary wrote 转账给新受益人。
extend_vesting write 延长行权期限。
add_tokens_to_vesting write 将代币添加到现有行权中。
transfer_vesting_creator write 转移创建者角色。
get_vesting_events 阅读 授予事件历史。

订单簿(7)

工具 类型 描述
list_order write 在预测市场下达限价卖出订单。
cancel_order write 取消未结订单。
buy_order write 填写一个订单。
buy_multiple_orders write 扫描多个订单。
get_order_cost read 填写订单的成本。
get_buy_order_amounts_out read 购买订单的金额。
get_orders read 列出市场订单。

税费(10)

工具 类型 描述
get_tax_rate read 代币+钱包的税率。
get_surge_tax read 当前激增的税收。
get_base_tax_rates read 所有令牌类型的基本费率。
get_available_surge_quota read 剩余激增配额。
start_surge_tax write 启动激增税(仅限创作者)。
end_surge_tax wrote 结束激增税。
add_dev_share write 添加开发费用份额。
remove_dev_share write 删除开发费用份额。
get_creator_earnings read 特定代币上开发人员的未分配应计美元收益。
get_dev_total_earnings read 终身分配的美元收益分布在开发人员拥有的每个代币上

珊瑚礁(14)

工具 类型 描述
get_reef_feed read 获取珊瑚礁帖子。
get_reef_highlights 阅读 突出显示的帖子。
get_reef_post read 带有评论的单条帖子。
get_reef_feed_by_wallet read 钱包里的帖子。
get_reef_votes read 为帖子投票。
create_reef_post write 创建帖子。
edit_reef_post 写 编辑你的帖子。
delete_reef_post write 删除你的帖子。
create_reef_comment 写 评论帖子。
edit_reef_comment 写 编辑你的评论。
delete_reef_comment write 删除您的评论。
vote_reef_post write 切换帖子的投票。
vote_reef_comment write 切换评论投票。
report_reef_post 写 报告一篇帖子。

私人市场(20)

工具 类型 描述
pm_create_market write 使用元数据创建私人预测市场。接受图像URL或本地文件。
pm_buy 在私人市场购买股票。
pm_redeem 写 兑换私人市场奖金。
pm_list_order write 列出卖出订单。
pm_cancel_order write 取消订单。
pm_buy_order write 填写订单。
pm_buy_multiple_orders write 扫描多个订单。
pm_buy_orders_and_contract 写 从订单簿+AMM购买。
pm_vote 写 对结果进行投票。
pm_finalize 写 确定市场。
pm_claim_bounty wrote 领取赏金。
pm_manage_voter write 添加/删除投票人。
pm_manage_whitelist write 管理白名单。
pm_toggle_buyers write 切换买家访问权限。
pm_disable_freeze write 向公众开放。
pm_get_market_data read 获取市场数据。
pm_get_user_shares read 获取您的股份。
pm_can_user_buy read 看看你能不能买。
pm_get_min_seed_public 阅读 非私人私人市场的最低美元种子。
pm_get_min_seed_private 阅读 选民小组私人市场的最低美元种子。

公用事业(8)

工具 类型 描述
claim_faucet wrote 申请每日USDB滴注(根据资格信号,最高可达500美元/天)。
get_faucet_status 阅读 检查水龙头的合格性、信号和冷却。
sync_transaction write 手动将tx同步到后端。
sync_loan write 同步贷款交易
sync_order write 同步顺序tx
request_twitter_challenge read 获取推特验证挑战。
verify_twitter write 验证推特挑战推文的帐户链接。
verify_social_tweet write 提交一条推特标签@LaunchOnBase以获取积分。最多3/天。

深度分辨率(13)

工具 类型 描述
get_final_outcome read 最终市场的最终结果。
get_resolver_constants 阅读 争议/提案期和保证金。
is_resolver_voter read 检查选民资格。
get_resolver_stake read 您的解析器赌注金额。
get_bounty_per_vote read 每票奖金分配。
get_vote_count read 争议回合的投票结果。
get_voter_choice 阅读 选民的选择。
veto_outcome 写 否决提议的结果(管理员)。
has_betted_on_market 阅读 检查你是否在市场上下注。
get_outcome read 单一结果数据。
get_initial_reserves read 结果的初始储备。
convert_to_assets 将 wSTASIS共享读取为STASIS值。
get_total_vault_assets read 总保险库TVL。

其他(11)

工具 类型 描述
update_my_profile write 更新用户名、头像或社交链接。
get_public_profile_referrals read 钱包的推荐数据。
get_verified_tweets 阅读 您已验证的推文。
submit_bug_report write 提交错误报告。
get_bug_reports read 获取错误报告。
create_project_comment 写 评论一个项目。
delete_project_comment write 删除项目注释。
get_project_comments read 获取项目注释。
upload_image_from_url write 从URL将图像上传到Basis(用于令牌或头像目的)。
upload_image_from_file write 将本地图像文件上传到Basis。适用于具有文件系统访问权限的代理。
set_avatar write 上传图片并设置为个人资料头像。

模具手册(5)

工具 类型 描述
link_moltbook write 开始链接Moltbook帐户。将挑战回复到帖子。
verify_moltbook write 验证挑战帖子以完成帐户链接。
get_moltbook_status read 查看Moltbook链接状态、帖子计数、因果报应。
verify_moltbook_post 写 提交一篇Moltbook帖子以获得积分(最多3/天)。
get_verified_moltbook_posts read 列出所有已验证的Moltbook帖子。

向上/向下(16)

资产为arg形状:每个工具都需要 asset: btc | eth | bnb | cake | doge。任何合约位于零地址的资产都会返回“尚未部署”错误。 tf 是 0=5m, 1=15m, 2=1h, 3=4h, 4=24h.

工具 类型 描述
updown_get_round read 按id对结构体进行舍入(如果是,则为当前舍入 round_id 省略)。
updown_get_user_bet 阅读 你赌一轮。 amount: 0 意味着没有赌注
updown_quote_shares read 预览假设赌注的股票。包括滑点。
updown_quote_claim read 从已结算的一轮中索赔确切的美元。0=无需索赔。
updown_bet write 下注牛市/熊市。自动批准USDB,预检查余额+minBet,可选 slippage_percent.
updown_claim wrote 领取奖金/退款。拒绝发送,如果 quote_claim 返回0。
updown_settle wrote 已结束回合的公开结算(任何人都可以打电话)。
updown_cancel_stalled write 结算窗口到期后公开取消(任何人都可以致电)。
updown_my_history read 汇总所有资产+时间范围内的投注/索赔摘要。
updown_list_rounds read 每个令牌的分页圆形列表,可选 tf / outcome 过滤器。
updown_bull_probability read 当前活跃轮次的牛市概率(bps+%)。
updown_quote_current_payout read 如果当前一轮结算对您有利,预计支出。
updown_min_bet read 每项资产的最低USDB投注金额。
updown_tf_duration read 一个时间段的循环持续时间(秒)。
updown_paused read 检查某项资产的投注是否暂停。
updown_slippage_threshold read 当前有效回合的BPS滑点阈值(衰减95%→55%).

运作原理

MCP服务器封装 基础TS SDK 进入模型上下文协议。SDK捆绑在里面,不需要单独安装。每个工具映射到一个或多个SDK方法,处理:

  • 令牌解析 --传递“STASIS”或原始地址
  • 金额转换 --人类可读的数字(例如。 50 =50亿美元)内部转换为18个十进制BigInt
  • 路径路由 --自动构建的工厂代币(USDB<>STASIS<>代币)的3跳交换路径
  • 护栏 --销售前的余额检查、杠杆前的模拟、投票/索赔重复数据删除
  • BigInt序列化 --所有链上值都安全地序列化为JSON

使用Claude代码

claude --mcp-server "node /path/to/MCP-TS/dist/index.js"

或添加到您的项目 .mcp.json:

{
  "basis": {
    "command": "node",
    "args": ["/path/to/MCP-TS/dist/index.js"],
    "env": {
      "BASIS_PRIVATE_KEY": "0xYOUR_KEY"
    }
  }
}

发布到npm

npm publish --access public

任何人都可以使用它:

{
  "mcpServers": {
    "basis": {
      "command": "npx",
      "args": ["-y", "@basis-markets/mcp-server"],
      "env": {
        "BASIS_PRIVATE_KEY": "0xTHEIR_KEY"
      }
    }
  }
}

许可证

弹性许可证2.0 --免费使用、修改和共享。不能作为托管/管理服务提供。