mcpField
M
MCP Server: Modern SDK Collection & Integration Platform

MCP Server: Modern SDK Collection & Integration Platform

本地服务
github.com/olaxbt开发工具1538 周前更新

关于 MCP Server: Modern SDK Collection & Integration Platform

OLAXBT MCP Server 是面向构建 DeFi、游戏和搜索等服务集成的模块化服务器,将动态服务管理与内置工具结合。

主要功能

  1. 01通过插件加载服务
  2. 02发现并监控服务
  3. 03动态管理服务
  4. 04支持 HTTP、SSE 和 WebSocket 连接
  5. 05内置网页搜索工具
  6. 06提供加密货币和 DeFi 工具

适用场景

  1. 01运行时添加或禁用集成
  2. 02将 MCP 请求路由到已注册服务
  3. 03通过 MCP 客户端搜索网页
  4. 04使用加密货币、DeFi 和 NFT 工具

MCP 相关

通过 MCP 端点提供本地工具和动态注册服务中的工具,支持 HTTP 和 SSE 连接。它还提供服务发现与生命周期管理。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

OLAXBT MCP 服务

一个现代化、模块化的 MCP(Model Context Protocol)服务,采用可扩展的服务架构,支持多个 MCP 服务,包括 DeFi、游戏和搜索工具。

功能特性

  • 模块化服务架构:基于插件的服务加载与管理
  • 服务注册表:动态服务发现、注册和健康监控
  • 多种连接类型:HTTP、SSE、WebSocket 和标准 MCP 协议
  • 服务管理:动态添加、移除、启用/禁用和重新加载服务
  • 内置工具:DuckDuckGo 搜索和增强型网页搜索
  • FastAPI 后端:高性能异步 Web 框架

快速开始

# Install dependencies
pip install -r requirements.txt

# Run server
python run.py

API 端点

核心端点
  • GET / - 服务信息和状态
  • GET /health - 健康检查及服务状态
  • GET /services - 列出所有已注册的服务
  • GET /tools - 列出所有可用工具
  • GET /statistics - 详细的服务和工具统计信息
服务管理
  • POST /services/reload/{service_id} - 重新加载指定服务
  • POST /services/load - 从配置加载服务
  • POST /services/add - 动态添加新服务
  • DELETE /services/{service_id} - 移除服务
  • POST /services/{service_id}/enable - 启用已禁用的服务
  • POST /services/{service_id}/disable - 禁用服务
  • GET /services/{service_id}/status - 获取详细的服务状态
MCP 协议端点
  • POST /mcp - 标准 MCP 端点(POST)
  • GET /mcp - 标准 MCP 端点(SSE)
  • GET /sse - 服务器发送事件端点
  • POST /api/mcp/olaxbt-gateway - 自定义 MCP 端点
旧版 MCP 端点
  • POST /mcp/tools/list - 列出所有可用工具
  • POST /mcp/tools/call - 调用指定工具
  • POST /mcp/services/list - 列出所有可用服务

使用示例

列出服务
curl http://localhost:3000/services
列出工具
curl http://localhost:3000/tools
获取服务状态
curl http://localhost:3000/services/meteora/status
MCP 协议请求
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}
工具使用示例
加密货币价格工具
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "crypto_price",
    "arguments": {
      "coin_id": "bitcoin",
      "vs_currency": "usd",
      "include_market_data": true,
      "include_24hr_change": true
    }
  }
}
投资组合跟踪工具
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "portfolio_tracker",
    "arguments": {
      "action": "create",
      "portfolio_id": "my_portfolio",
      "name": "My Crypto Portfolio"
    }
  }
}
DeFi 协议工具
{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "defi_protocol",
    "arguments": {
      "protocol": "meteora",
      "action": "pools"
    }
  }
}
市场分析工具
{
  "jsonrpc": "2.0",
  "id": 4,
  "method": "tools/call",
  "params": {
    "name": "market_analysis",
    "arguments": {
      "coin_id": "bitcoin",
      "analysis_type": "technical_indicators",
      "timeframe": "7d"
    }
  }
}
APY 计算器工具
{
  "jsonrpc": "2.0",
  "id": 5,
  "method": "tools/call",
  "params": {
    "name": "apy_calculator",
    "arguments": {
      "calculation_type": "liquidity_pool",
      "protocol": "meteora",
      "principal": 10000,
      "time_period": 365
    }
  }
}
NFT 市场工具
{
  "jsonrpc": "2.0",
  "id": 6,
  "method": "tools/call",
  "params": {
    "name": "nft_marketplace",
    "arguments": {
      "action": "collection_stats",
      "collection_slug": "bored-ape-yacht-club",
      "chain": "ethereum"
    }
  }
}
NFT 地板价
{
  "jsonrpc": "2.0",
  "id": 7,
  "method": "tools/call",
  "params": {
    "name": "nft_marketplace",
    "arguments": {
      "action": "floor_price",
      "collection_slug": "degen-ape-academy",
      "chain": "solana"
    }
  }
}
添加新服务
curl -X POST http://localhost:3000/services/add \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Service",
    "description": "Custom service description",
    "url": "http://localhost:3003",
    "tools": ["my_tool"],
    "metadata": {"category": "custom"}
  }'

服务配置

可通过以下方式配置服务:

  • 配置文件
  • 动态 API 调用
  • 环境变量

架构

Client → MCP Gateway → Service Manager → Service Registry
                    ↓
                Router → Local Tools

该服务提供:

  • 服务管理器:处理服务生命周期和配置
  • 服务注册表:管理服务注册和健康监控
  • 路由器:将请求路由到相应服务或本地工具
  • 本地工具:内置搜索和实用工具

本地开发

  1. 安装依赖项:
pip install -r requirements.txt
  1. 在本地运行:
python run.py
  1. 添加新服务:
python scripts/add_service.py
可用工具

MCP 服务包含以下全面的工具:

  • 加密货币价格数据
  • DeFi 协议交互
  • 投资组合跟踪与分析
  • 加密货币新闻聚合
  • NFT 市场数据
  • 市场分析和技术指标
  • APY 计算
  • 社交媒体集成
  • 通信工具
  • 实用功能

所有工具都包含全面的错误处理,并会在 API 不可用时回退到合理的默认值。

部署

可部署到任何支持 Python 应用的服务器:

  1. 将代码上传到服务器
  2. 安装依赖项: pip install -r requirements.txt
  3. 运行服务: uvicorn app.mcp.server:app --host 0.0.0.0 --port 3000
  4. 设置环境变量:
    MCP_HOST=0.0.0.0
    MCP_PORT=3000
    MCP_DEBUG=false
    

VSCode 集成

添加 .vscode/mcp.json 以使用 HTTP 或 SSE 连接:

{
  "servers": {
    "olaxbt-mcp": {
      "url": "http://localhost:3000/mcp",
      "type": "http"
    }
  },
  "inputs": []
}

可用工具

本地工具
搜索与信息工具
  • duckduckgo_search - 使用 DuckDuckGo 进行网页搜索
  • web_search - 增强型搜索(文本、新闻、图片、视频)
  • crypto_news - 加密货币专属新闻聚合与情绪分析
加密货币与 DeFi 工具
  • crypto_price - 获取 CoinGecko 的实时加密货币价格和市场数据
  • defi_protocol - 与 DeFi 协议交互(Meteora 流动性池、Jupiter 兑换聚合器)
  • portfolio_tracker - 通过实时定价跟踪和分析加密货币投资组合
  • apy_calculator - 使用真实 DeFi 协议数据计算 APY:
    • 流动性池 APY,并估算无常损失
    • 收益耕种 APY,并计算复利
    • 使用真实协议数据计算质押 APY
    • 计算复利,并按月细分
    • 获取 CoinGecko 的实时 DeFi 协议数据
NFT 与游戏工具
  • nft_marketplace - 获取 OpenSea、Magic Eden 和其他主要市场的实时 NFT 市场数据
    • 系列信息和统计数据
    • 地板价及其 24 小时 / 7 天变化
    • 交易量和销售数据
    • 包含交易详情的近期销售记录
    • 支持 Ethereum、Solana 和 Polygon 链
市场分析工具
  • market_analysis - 使用实时数据进行高级市场分析:
    • 技术指标(RSI、MACD、布林带、移动平均线)
    • 趋势分析,包括动量和关键价位
    • 使用恐惧与贪婪指数及社交指标分析市场情绪
    • 使用风险指标(VaR、夏普比率、索提诺比率)进行波动性分析
    • 获取 CoinGecko API 的实时数据
实用工具
  • notification - 设置和管理提醒,并接入实时市场数据:
    • 价格提醒,实时检查 CoinGecko 价格
    • 加密货币和 DeFi 主题的新闻提醒
    • 基于市场摘要数据的投资组合提醒
    • 集成实时市场数据以测试提醒
服务工具

工具会从已注册的服务动态加载,包括:

  • DeFi 协议(Meteora 等)
  • 游戏平台(GMGN 等)
  • 分析服务
  • 自定义集成

项目结构

app/mcp/
├── server.py           # Main server with FastAPI
├── service_manager.py  # Service lifecycle management
├── router.py           # Request routing and MCP handling
├── config.py           # Configuration management
├── tools.py            # Local tool implementations
└── services/           # Service implementations
    ├── base_service.py # Base service class
    ├── meteora.py      # Meteora DeFi service
    └── gmgn.py         # GMGN Gaming service

运行要求

  • Python 3.8+
  • FastAPI
  • uvicorn
  • duckduckgo-search
  • aiohttp
  • websockets
  • pydantic

环境变量

如需完整功能,请设置以下环境变量:

# NFT Marketplace APIs (optional but recommended)
OPENSEA_API_KEY=your_opensea_api_key_here
RESERVOIR_API_KEY=your_reservoir_api_key_here

# Server Configuration
MCP_HOST=0.0.0.0
MCP_PORT=3000
MCP_DEBUG=false
获取 API 密钥
  1. OpenSea API 密钥:

  2. Reservoir API 密钥(可选):

注意:NFT 市场工具无需 API 密钥即可使用,但会受到速率限制。API 密钥可提供更高的速率限制和更好的可靠性。

在 BNB Chain 上与 Nexus 搭配使用

你可以将此服务作为 OlaXBT Nexus 技术栈的一部分运行,并直接在 BNB Chain(BSC / BNB Smart Chain) 上结算用量。

使用 BNB Chain 上的 BNB 或受支持的稳定币为连接到 Nexus 的钱包充值,然后通过 Nexus 界面购买额度;所有计量用量都会在 BNB Chain 上以低廉费用结算,之后还可扩展至 opBNB 或与 Greenfield 对齐的工作流。

这样,Agent 和交易工具便可通过 Nexus 使用数据和执行操作,同时让支付和记账原生融入 BNB Chain 生态系统。

许可证

本项目采用 MIT 许可证。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。