基础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 --免费使用、修改和共享。不能作为托管/管理服务提供。