AI导哈

模型上下文协议服务器

SODAX MCP Server是一个统一的模型上下文协议服务器，使AI助手能够访问品牌指南和实时API数据。

  • by icon-project
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 icon-project/sodax-mcp-server

使用说明

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文档）：

  1. 创建 src/services/sdkDocs.ts 具有提取逻辑
  2. 创建 src/tools/sdkDocs.ts 带有工具定义
  3. 在中注册工具 src/index.ts

许可证

麻省理工学院

相关 MCP