SODAX MCP服务器
SODAX的统一MCP(模型上下文协议)服务器。使人工智能助手能够访问品牌指南、API实时数据等。
概述
该服务器为AI助手查询SODAX资源提供了一个web界面和MCP端点。
登录页面: 访问部署的URL以查看连接说明和可用工具。
MCP生态系统
要获得完整的SODAX上下文,请配置这些MCP服务器:
| MCP服务器 | URL | 描述 |
|---|---|---|
| 碳酸钠MCP (此回购) | https://your-domain.com/mcp | 品牌圣经+API实况数据 |
| SDK文档 (GitBook) | https://docs.sodax.com/~gitbook/mcp | 开发人员文档、代码示例 |
包含什么
| 来源 | 描述 | 自动更新 |
|---|---|---|
| 品牌圣经 | 指导方针、语音、视觉识别、消息传递 | ✅ 每5分钟从Notion出发 |
| API SODAX公司 | 链、代币、交易、数量、合作伙伴 | ✅ 来自api.sodax.com的直播 |
可用工具
品牌圣经工具(6个工具)
| 工具 | 说明 |
|---|---|
sodax_get_brand_overview | 获取品牌圣经的高级概述 |
sodax_get_section | 获取特定部分(1-6) |
sodax_get_subsection | 获取一个特定的小节(例如3.1) |
sodax_search_brand_bible | 按关键字搜索品牌指南 |
sodax_refresh_brand_bible | 强制刷新缓存数据 |
sodax_list_subsections | 列出所有小节以供参考 |
SODAX API工具(10个工具)
| 工具 | 说明 |
|---|---|
sodax_get_supported_chains | 列出所有支持的区块链网络 |
sodax_get_swap_tokens | 获取可用的代币进行交换 |
sodax_get_transaction | 按哈希查找交易 |
sodax_get_user_transactions | 获取用户的交易历史记录 |
sodax_get_volume | 获取交易量数据 |
sodax_get_orderbook | 获取当前订单条目 |
sodax_get_money_market_assets | 列出借出/借入资产 |
sodax_get_user_position | 获取用户的货币市场头寸 |
sodax_get_partners | 列出SODAX集成合作伙伴 |
sodax_get_token_supply | 获取SODA代币供应信息 |
部署选项
选项1:Docker(推荐)
docker build -t sodax-mcp-server .
docker run -p 3000:3000 sodax-mcp-server选项2:Docker编写
docker-compose up -d选项3:直接使用Node.js
pnpm install
pnpm build
pnpm start选项4:PM2(流程管理器)
pnpm install
pnpm build
pm2 start dist/index.js --name sodax-mcp选项5:系统化服务
# /etc/systemd/system/sodax-mcp.service
[Unit]
Description=SODAX MCP Server
After=network.target
[Service]
Type=simple
User=www-data
WorkingDirectory=/opt/sodax-mcp-server
ExecStart=/usr/bin/node dist/index.js
Restart=on-failure
Environment=NODE_ENV=production
Environment=PORT=3000
[Install]
WantedBy=multi-user.target环境变量
| 变量 | 默认值 | 描述 |
|---|---|---|
PORT | 3000 | 服务器端口 |
TRANSPORT | http | 运输类型(http 或 stdio) |
NODE_ENV | - | 设置为 production 用于生产 |
API终点
| 端点 | 方法 | 描述 |
|---|---|---|
/ | GET | 带有连接说明的登录页面 |
/api | GET | 服务器信息和可用工具(JSON) |
/health | GET | 健康检查 |
/mcp | POST | MCP协议端点 |
连接AI助手
克劳德桌面版
添加到 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"sodax-brand": {
"url": "https://your-domain.com/mcp"
},
"sodax-docs": {
"url": "https://docs.sodax.com/~gitbook/mcp"
}
}
}光标
添加到MCP设置:
{
"mcpServers": {
"sodax-brand": {
"url": "https://your-domain.com/mcp"
},
"sodax-docs": {
"url": "https://docs.sodax.com/~gitbook/mcp"
}
}
}地方发展(stdio)
{
"mcpServers": {
"sodax": {
"command": "node",
"args": ["/path/to/sodax-mcp-server/dist/index.js"],
"env": {
"TRANSPORT": "stdio"
}
}
}
}示例用法
连接后,您可以向您的AI助手询问以下问题:
"Does this tweet align with SODAX brand voice?"
"What colors should I use for this design?"
"Review this blog post for brand alignment"
"What's our positioning statement?"
"What chains does SODAX support?"
"Show me today's trading volume"人工智能将自动使用适当的工具来获取品牌指南和实时数据。
发展
pnpm install # Install dependencies
pnpm dev # Run with auto-reload
pnpm build # Build for production
pnpm start # Run production server项目结构
sodax-mcp-server/
├── src/
│ ├── index.ts # Server entry point
│ ├── constants.ts # Configuration
│ ├── types.ts # TypeScript types
│ ├── services/
│ │ ├── brandBible.ts # Brand bible fetching/parsing
│ │ └── sodaxApi.ts # SODAX REST API client
│ ├── tools/
│ │ ├── brandBible.ts # Brand bible tool definitions
│ │ └── sodaxApi.ts # SODAX API tool definitions
│ └── public/
│ └── index.html # Landing page
├── Dockerfile
├── docker-compose.yml
└── package.json添加新来源
要添加新的数据源(例如SDK文档):
- 创建
src/services/sdkDocs.ts具有提取逻辑 - 创建
src/tools/sdkDocs.ts带有工具定义 - 在中注册工具
src/index.ts
许可证
麻省理工学院
