MCP Client Skill

Description

--- name: mcp-client description: Connect OpenClaw to any MCP (Model Context Protocol) server - Swiggy, Zomato, GitHub, and hundreds more! version: 1.0.0 author: Toki (OpenClaw Assistant) --- # MCP Client Skill Connect OpenClaw to the entire MCP ecosystem! ## What This Skill Does This skill enables OpenClaw to communicate with **any** HTTP-based MCP (Model Context Protocol) server, giving you instant access to: - 🍛 **Swiggy** - Food ordering, groceries (Instamart), table booking (Dineout) - 🍕 **Zomato** - Restaurant discovery and food ordering - 💻 **GitHub** - Code, issues, PRs (when configured) - 💬 **Slack** - Team communication (when configured) - 🗄️ **Databases** - PostgreSQL, MySQL, MongoDB (when configured) - 🔌 **And hundreds more MCP servers!** ## Installation ```bash cd ~/.openclaw/workspace/skills git clone https://github.com/ImrKhn03/openclaw-mcp-client.git cd openclaw-mcp-client npm install ``` ## Configuration ### Add MCP Servers Create JSON config files in the `servers/` directory: ```json { "name": "my-server", "type": "http", "url": "https://mcp.example.com", "enabled": true, "description": "My custom MCP server", "oauth": { "required": false } } ``` **Pre-configured servers:** - ✅ Swiggy Food (`swiggy-food.json`) - ✅ Swiggy Instamart (`swiggy-instamart.json`) - ✅ Zomato (`zomato.json`) ### OAuth Setup (For Swiggy/Zomato) When a server requires OAuth, the skill will: 1. Print an authorization URL 2. Start a local callback server 3. Wait for you to authorize in your browser 4. Automatically save the token ## Usage Once installed, the skill automatically registers all MCP tools as OpenClaw commands! ### Real-World Usage Examples #### 🛒 Grocery Shopping (Swiggy Instamart) **You:** "I need milk and bread from Instamart" **OpenClaw:** 1. Searches Instamart for "milk" and "bread" 2. Shows product options with prices 3. Asks which ones you want 4. Adds to cart 5. Shows cart summary 6. Places order on confirmation **Example conversation:** ``` You: Order milk from Instamart Bot: Found these options: 1. Nandini Toned Milk 500ml - ₹24 2. Amul Gold Milk 500ml - ₹32 3. Mother Dairy Milk 500ml - ₹26 You: The first one Bot: Added Nandini Toned Milk to cart! Cart Total: ₹24 Delivery: FREE (minimum order met) Place order? You: Yes Bot: ✅ Order placed! Order ID: #123456 ETA: 15 minutes ``` #### 🍛 Food Ordering (Swiggy) **You:** "Find good biryani places" **OpenClaw:** 1. Searches Swiggy for biryani restaurants 2. Shows top-rated options nearby 3. Displays menus 4. Helps add items to cart 5. Manages order placement **Example:** ``` You: Order chicken biryani for lunch, budget ₹300 Bot: Found 8 restaurants! Top picks: 1. Paradise Biryani - ₹250 (4.5⭐, 25 min) 2. Meghana Biryani - ₹280 (4.6⭐, 30 min) 3. Empire Restaurant - ₹220 (4.4⭐, 20 min) You: Meghana looks good Bot: Meghana Biryani menu: - Chicken Dum Biryani (full) - ₹280 - Chicken 65 Biryani - ₹300 - Chicken Fry Piece Biryani - ₹290 You: The first one Bot: Added Chicken Dum Biryani to cart! Total: ₹280 + ₹40 delivery = ₹320 Continue to checkout? ``` #### 🔍 Restaurant Discovery (Zomato) **You:** "Show me top Italian restaurants with outdoor seating" **OpenClaw:** 1. Searches Zomato with filters 2. Shows restaurants matching criteria 3. Displays reviews, ratings, prices 4. Can book tables (if Dineout integrated) #### 🛠️ Multi-Server Workflows **You:** "Compare biryani prices between Swiggy and Zomato" **OpenClaw:** 1. Searches both platforms simultaneously 2. Compares prices, ratings, delivery times 3. Presents side-by-side comparison 4. Lets you choose the best option ### Natural Language Commands The skill understands these patterns: **Food Ordering:** - "Order [food] from [service]" - "Find [cuisine] restaurants" - "Show me the menu for [restaurant]" - "What's good at [restaurant]?" - "Add [item] to cart" **Groceries:** - "Buy [item] from Instamart" - "Search for [product]" - "Add [item] to grocery cart" - "Check my Instamart cart" - "Place grocery order" **General:** - "What MCP tools are available?" - "Check my [service] orders" - "Track order #[id]" - "What can you do with MCP?" ### Natural Language Examples (Original) ``` "Order biryani from Swiggy" -> Searches restaurants, shows menu, helps order "Find Italian restaurants near me on Zomato" -> Uses Zomato MCP to search "Add milk to my Instamart cart" -> Uses Swiggy Instamart MCP "What tools are available?" -> Lists all registered MCP tools ``` ### Programmatic Usage ```javascript const MCPClient = require('./index'); const client = new MCPClient(); await client.initialize(); // List all tools const tools = client.getTools(); // Search for specific tools const foodTools = client.searchTools('restaurant'); // Call a tool const result = await client.callTool('swiggy-food', 'search_restaurants', { location: { lat: 12.9351929, lng: 77.62448069999999 }, query: 'biryani' }); ``` ## How It Works 1. **Discovery**: Skill loads all JSON configs from `servers/` 2. **Connection**: Connects to each enabled MCP server 3. **Tool Registration**: Fetches available tools from each server 4. **Dynamic Integration**: Registers tools as OpenClaw commands 5. **Execution**: Routes tool calls to the appropriate MCP server ## Skill Behavior When you mention food ordering, restaurants, or grocery shopping, the skill: 1. Detects which MCP server is relevant (Swiggy, Zomato, etc.) 2. Checks if OAuth is required 3. Calls the appropriate MCP tool 4. Formats and presents results 5. Helps complete the action (ordering, booking, etc.) ## Extending ### Add New MCP Servers Just drop a JSON config in `servers/`: ```json { "name": "github", "type": "http", "url": "https://mcp.github.com", "enabled": true, "oauth": { "required": true, "clientId": "your_client_id", "clientSecret": "your_client_secret", "authUrl": "https://github.com/login/oauth/authorize", "tokenUrl": "https://github.com/login/oauth/access_token", "scopes": ["repo", "user"] } } ``` Restart OpenClaw and the new server is ready! ## Troubleshooting ### Connection Issues ```bash # Test connectivity node index.js # Should show all discovered tools ``` ### OAuth Problems - Check that redirect URI matches: `http://localhost:3000/oauth/callback` - Verify client ID and secret in server config - Ensure server has whitelisted the redirect URI ### Tool Not Found ```bash # List all available tools node index.js ``` ## Architecture ``` ┌─────────────────┐ │ OpenClaw │ └────────┬────────┘ │ ┌────▼─────┐ │ MCP Skill │ (this skill) └────┬─────┘ │ ┌────▼──────────┐ │ MCP Manager │ Manages multiple servers └────┬──────────┘ │ ┌────▼──────┬──────────┬─────────┐ │ │ │ │ ┌───▼────┐ ┌───▼────┐ ┌───▼────┐ ┌──▼────┐ │ Swiggy │ │ Zomato │ │ GitHub │ │ ... │ └────────┘ └────────┘ └────────┘ └───────┘ ``` ## Troubleshooting ### OAuth Not Working **Symptoms:** - Getting 401/403 errors when calling tools - OAuth wizard completes but tools still fail **Solutions:** 1. Check OAuth status: `npm run oauth:status` 2. Re-run OAuth wizard for the failing server: `npm run oauth <server-name>` 3. Verify server config has correct OAuth endpoints 4. Check `.oauth-tokens.json` has a valid token for the server ### Tools Not Showing Up **Symptoms:** - `npm run list-tools` shows no tools or fewer than expected - Server is enabled but tools missing **Solutions:** 1. Check server is enabled in config: `"enabled": true` 2. Verify server URL is reachable: `curl <server-url>/mcp/v1/tools` 3. Check for errors in console output when running commands 4. Try disabling and re-enabling the server ### Connection Errors **Symptoms:** - `ECONNREFUSED`, `ETIMEDOUT`, or network errors - "Failed to fetch tools" messages **Solutions:** 1. Verify server URL is correct (include `https://`) 2. Check if server requires VPN or specific network access 3. Test server URL in browser or with curl 4. Check if server requires authentication (OAuth setup needed) ### "Server Not Found" Errors **Symptoms:** - Error: `Server '<name>' not found` **Solutions:** 1. Check server config file exists in `servers/` directory 2. Verify filename matches: `<server-name>.json` 3. Ensure JSON is valid (no syntax errors) 4. Check server name in config matches what you're calling ### OAuth Tokens Expired **Symptoms:** - Tools worked before, now getting auth errors - "Token expired" or "Invalid token" messages **Solutions:** 1. Re-run OAuth wizard: `npm run oauth <server-name>` 2. Check if server requires token refresh (some expire quickly) 3. Verify `.oauth-tokens.json` is not corrupted ### Installation Issues **Symptoms:** - `npm install` fails - Missing dependencies errors **Solutions:** 1. Check Node.js version: `node -v` (need v18+) 2. Clear npm cache: `npm cache clean --force` 3. Delete `node_modules` and `package-lock.json`, then `npm install` again 4. Check internet connection for package downloads ### Common Mistakes ❌ **Calling tools before OAuth setup** - Many servers require OAuth. Run `npm run oauth:status` first ❌ **Wrong server name in calls** - Use exact server name from config file (case-sensitive) ❌ **Disabled servers** - Check `"enabled": true` in server config ❌ **Missing required parameters** - Each tool has required parameters - check with `list-tools` for schema ### Getting Help If you're still stuck: 1. Check the logs in console output (look for error messages) 2. Review server config JSON for typos 3. Test the MCP server URL directly with curl 4. Open an issue on GitHub with error details --- ## Development Built by **Toki** (OpenClaw Assistant) for @ImrKhn03 and the OpenClaw community! ### Contributing PRs welcome! Please: - Add tests for new features - Update documentation - Follow existing code style ## License MIT License - See LICENSE file ## Links - GitHub: https://github.com/ImrKhn03/openclaw-mcp-client - ClawdHub: (Publishing soon!) - MCP Spec: https://spec.modelcontextprotocol.io/ --- **Built with ❤️ by Toki** *Making OpenClaw even more powerful!* 🦞

Security Status