README Documentation
OKX-DEX-SDK MCP SSE SERVER EXAMPLE
This is an example implementation of an SSE (Server-Sent Events) MCP server that leverages @okx-dex/okx-dex-sdk to support DEX trading and cross-chain bridge operations.
🚀 Features
DEX API
Built for the Solana blockchain, the DEX API supports:
- Executing swap trades
- Generating swap instructions
- Fetching price quotes
- Retrieving supported tokens and liquidity pool (LP) data
Bridge API
Enables cross-chain functionality, including:
- Fetching supported bridgeable tokens and chains
- Performing cross-chain bridge transactions
- Retrieving cross-chain price quotes
📦 Installation
git clone https://github.com/0xobedient/okx-mcp
cd okx-mcp
pnpm install
pnpm run dev
📁 Project Structure
.
├── build/ # Compiled output
├── node_modules/ # Node.js dependencies
├── src/
│ ├── bridge/
│ │ ├── hooks/ # Bridge-specific hooks
│ │ ├── tools/ # Utility functions for bridge
│ │ └── server.ts # SSE server for bridge API
│ ├── dex/
│ │ ├── hooks/ # DEX-specific hooks
│ │ ├── tools/ # Utility functions for DEX
│ │ └── server.ts # SSE server for DEX API
│ └── shared/
│ ├── common/
│ │ ├── okxClient.ts # OKX SDK client wrapper
│ │ └── wallet.ts # Wallet handling logic
│ ├── constants/
│ │ └── index.ts # Constant values used across the app
│ ├── env/
│ │ └── index.ts # Environment variable loader
│ ├── types/
│ │ ├── tool.d.ts # Type definitions for tools
│ │ └── wallet.d.ts # Type definitions for wallet
│ └── main.ts # Application entry point
├── .env.example # Sample environment file
├── .gitignore # Git ignore rules
├── package.json # NPM package metadata
├── pnpm-lock.yaml # Lockfile for pnpm
└── tsconfig.json # TypeScript configuration
🔐 Environment Variables
Create a .env
file at the root of the project using .env.example
as a template:
OKX_API_KEY= # Your OKX API key
OKX_API_SECRET= # Your OKX API secret
OKX_PASSPHRASE= # Your OKX API passphrase
OKX_PROJECT_ID= # Your OKX project ID (if required)
RPC_ENDPOINT_URI= # RPC endpoint URI for Solana or target blockchain
WALLET_PRIVATE_KEY= # Private key for the wallet used in trades
PORT=3000 # Port number for the SSE server
📦 Dependency
This MCP server is entirely built upon the official OKX SDK:
@okx-dex/okx-dex-sdk – the core SDK providing access to OKX DEX trading and bridge functionalities.
Quick Actions
Key Features
Model Context Protocol
Secure Communication
Real-time Updates
Open Source