README.md•2.15 kB
# Multi-MCPs
Multi-MCPs is a Model Context Protocol (MCP) server that aggregates multiple third-party APIs and exposes them as unified MCP tools. It ships with out-of-the-box support for the top 10 commonly used external services: OpenWeather, Google Maps/Places, NewsAPI, GitHub, Notion, Trello, Spotify, Twilio, Unsplash, and CoinGecko.
## Install
```bash
npm i
```
## Run
Build:
```bash
npm run build
```
Run as an MCP server (stdio):
```bash
npx @modelcontextprotocol/inspector build/index.js
```
## Configuration
Provide credentials via environment variables or `config/api-configs.json`. Environment variables take precedence over file values.
Example `config/api-configs.json`:
```json
{
"OPENWEATHER_API_KEY": "...",
"GOOGLE_API_KEY": "...",
"NEWS_API_KEY": "...",
"GITHUB_TOKEN": "...",
"NOTION_TOKEN": "...",
"TRELLO_KEY": "...",
"TRELLO_TOKEN": "...",
"SPOTIFY_CLIENT_ID": "...",
"SPOTIFY_CLIENT_SECRET": "...",
"TWILIO_ACCOUNT_SID": "...",
"TWILIO_AUTH_TOKEN": "...",
"UNSPLASH_ACCESS_KEY": "..."
}
```
You can also point to a custom config file with:
```bash
export MUTI_MCPS_CONFIG=/abs/path/to/api-configs.json
```
## Available Tools (selection)
- Weather: `get_current_weather`, `get_weather_forecast`, `get_weather_alerts`
- Maps: `search_places`, `get_directions`, `geocode_address`
- News: `get_top_headlines`, `search_news`, `get_sources`
- GitHub: `search_repositories`, `get_repository_info`, `create_issue`, `list_commits`
- Notion: `query_database`, `create_page`, `update_page`, `search_pages`
- Trello: `get_boards`, `create_card`, `update_card`, `get_board_cards`
- Spotify: `search_tracks`, `get_track_info`, `create_playlist`, `add_tracks_to_playlist`
- Twilio: `send_sms`, `make_call`, `get_message_history`
- Unsplash: `search_photos`, `get_random_photo`, `get_photo_details`
- CoinGecko: `get_coin_price`, `get_trending_coins`, `get_market_data`
Note: Tools are listed even if credentials are missing; calls will fail with a clear error if the required credentials are not configured.
## License
This project is licensed under the MIT License. See `LICENSE` for details.