使用说明
⚠️ 实验性——仅用于测试目的 此MCP服务器是一个社区构建的项目，不受Carbon-DeFi核心团队的正式支持。 使用风险自负。非常欢迎投稿、反馈和错误报告——请参阅 贡献 在......下面
Carbon DeFi MCP服务器
一个MCP服务器，允许AI代理在Carbon DeFi上创建和管理链上制造商的交易策略。服务器将代理意图转换为未签名的事务——用户签名并广播。
创客第一。 代理商预先设定价格。策略在链上自动执行，填充时气体为零。没有代理需要保持在线。
代理集成
通过Skills CLI安装（适用于Claude Desktop、Cursor和支持agent Skills标准的任何代理）：
npx skills add ashachaf/carbon-mcp-server
| 文件 | 描述 |
|---|---|
SKILL.md |
Agent Skills标准--可通过安装 npx skills add |
AGENTS.md |
完全与代理无关的行为规则和交易惯例 |
CLAUDE.md |
Claude/MCP特定设置和工具列表 |
OPENAI.md |
ChatGPT/OpenAI函数调用设置 |
快速开始
添加 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"carbon-defi": {
"command": "npx",
"args": ["mcp-remote", "https://carbon-mcp.duckdns.org/mcp"]
}
}
}
更新配置后重新启动Claude Desktop。
端点
| 端点 | 方法 | 描述 |
|---|---|---|
/mcp |
POST | MCP可流式HTTP传输 |
/health |
GET | 服务器健康检查 |
/info |
GET | 服务器元数据、工具列表和连接配置 |
支撑链
| 链 | 状态 |
|---|---|
| 以太坊 | ✅ |
| Sei | ✅ |
| Celo | ✅ |
| TAC | ✅ |
工具
阅读
| 工具 | 说明 |
|---|---|
carbon_get_strategies |
获取钱包中所有活跃的创客策略。总是先打电话。 |
创建
| 工具 | 说明 |
|---|---|
carbon_create_limit_order |
一次性以单一确切价格买入或卖出。 |
carbon_create_range_order |
在价格范围内逐步执行的一次性买入或卖出。对DCA有好处。 |
carbon_create_recurring_strategy |
无限期重复的关联买入+卖出策略。低买高卖，零加油。 |
carbon_create_concentrated_strategy |
具有明确利差的双向集中流动性。赚取双方的费用。 |
carbon_create_full_range_strategy |
在尽可能宽的价格范围内（高达市场价格的1000倍）提供双向流动性。 |
管理
| 工具 | 说明 |
|---|---|
carbon_reprice_strategy |
在单笔交易中调整现有策略的价格范围。 |
carbon_edit_strategy |
在一个交易中同时编辑价格和预算。 |
carbon_deposit_budget |
为现有战略增加资金。 |
carbon_withdraw_budget |
在不关闭策略的情况下提取资金。 |
carbon_pause_strategy |
暂停积极的策略。资金仍留在战略中。 |
carbon_resume_strategy |
通过恢复价格区间来恢复暂停的策略。 |
carbon_delete_strategy |
永久关闭策略并退还所有资金。不可逆转。 |
运作原理
- 代理调用创建或管理工具
- 服务器验证输入，检查令牌许可，并构建事务
- 服务器返回 未签名交易 (
to,data,value) - 用户在钱包中评论和签名
- 策略在链上执行——没有代理需要保持在线
价格公约
所有价格均表示为 每1个基本令牌的报价令牌.
base_token--正在购买或出售的代币（例如ETH）quote_token--定价代币（例如USDC）- 价格为
2000指每1 ETH 2000美元
预算公约
buy_budget--总是在 报价令牌 （例如，USDC用于购买ETH）sell_budget--总是在 基本令牌 （例如出售ETH）
原生ETH
使用 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE 对于原生ETH——永远不要WETH。ETH从不需要批准。
全方位战略
全范围策略自动计算尽可能宽的价格范围：
factor = min(market_price / protocol_min, protocol_max / market_price, 1000)
price_low = market_price / factor
price_high = market_price * factor
用户为一个锚侧提供预算(buy 或 sell)另一个是自动计算的。
合同地址
| 链 | 碳控制器 | 优惠券 |
|---|---|---|
| 以太坊 | 0xC537e898CD774e2dCBa3B14Ea6f34C93d5eA45e1 |
0x3660F04B79751e31128f6378eAC70807e38f554E |
| Sei | 0xe4816658ad10bF215053C533cceAe3f59e1f1087 |
0xA4682A2A5Fe02feFF8Bd200240A41AD0E6EaF8d5 |
| Celo | 0x6619871118D144c1c28eC3b23036FC1f0829ed3a |
0x5E994Ac7d65d81f51a76e0bB5a236C6fDA8dBF9A |
| TAC | 0xA4682A2A5Fe02feFF8Bd200240A41AD0E6EaF8d5 |
0xb0d39990E1C38B50D0b7f6911525535Fbacb4C26 |
自我寄宿
需求
- Node.js v20+
- 您要支持的每个链的EVM RPC URL
设置
git clone https://github.com/ashachaf/carbon-mcp-server.git
cd carbon-mcp-server
npm install
创建一个 .env 文件-- 永远不要提交此文件:
PORT=3000
RPC_URL_ETHEREUM=
CHAIN_ID_ETHEREUM=1
RPC_URL_SEI=
RPC_URL_CELO=
RPC_URL_TAC=
运行服务器：
npx ts-node src/index.ts
或者使用PM2进行生产：
pm2 start src/index.ts --name carbon-mcp-server --interpreter ts-node
更新您的Claude Desktop配置以指向您的本地服务器：
{
"mcpServers": {
"carbon-defi": {
"command": "npx",
"args": ["mcp-remote", "http://localhost:3000/mcp"]
}
}
}
堆栈
- Node.js v20、TypeScript、ts节点
- @班科尔/碳sdk
- @模型上下文协议/sdk
- PM2，Nginx，让我们加密SSL
贡献
该项目对社区捐款开放。如果您想帮助改进Carbon DeFi MCP服务器：
- 报告错误 --打开一个问题 GitHub
- 建议功能 --打开讨论或问题
- 提交PR --欢迎所有投稿
这是一个实验性的整合。Carbon-DeFi协议本身是生产级的——这个MCP服务器层是社区构建和发展的。
