MCP Multi-API Server

MCP Multi-API Server 🌉

A Model Context Protocol (MCP) server that bridges AI/LLMs with multiple real-world APIs including weather, finance, and news services. This server acts as a standardized interface, allowing any MCP-compatible AI application to seamlessly interact with external APIs without custom integration work.

🚀 Features

Multi-API Support: Weather (OpenWeatherMap), Finance (Alpha Vantage), News (NewsAPI)
MCP Protocol Compliant: Full implementation of Anthropic's MCP standard
Intelligent Caching: Configurable TTL-based caching to reduce API calls
Rate Limiting: Built-in rate limiting to respect API quotas
Comprehensive Logging: Winston-based logging with multiple transports
Error Handling: Robust error handling with meaningful error messages
TypeScript: Fully typed for better developer experience

📋 Prerequisites

Node.js 18+
npm or yarn
API keys for:

🛠️ Installation

Clone the repository:

git clone https://github.com/yourusername/mcp-multi-api-server.git
cd mcp-multi-api-server

Install dependencies:

npm install

Copy the environment template and add your API keys:

cp .env.example .env

Edit .env and add your API keys:

OPENWEATHER_API_KEY=your_key_here
ALPHA_VANTAGE_API_KEY=your_key_here
NEWS_API_KEY=your_key_here

Build the project:

npm run build

🚀 Usage

Starting the Server

npm start

For development with auto-reload:

npm run dev

🏗️ Architecture

src/
├── index.ts          # Entry point & MCP server setup
├── api/              # API client implementations
├── tools/            # MCP tool definitions
├── utils/            # Utilities (cache, rate limiter, logger)
└── types/            # TypeScript type definitions

⚙️ Configuration

Environment Variables

Variable	Description	Default
`OPENWEATHER_API_KEY`	OpenWeatherMap API key	Required
`ALPHA_VANTAGE_API_KEY`	Alpha Vantage API key	Required
`NEWS_API_KEY`	NewsAPI key	Required
`MCP_SERVER_PORT`	Server port	3000
`LOG_LEVEL`	Logging level	info
`CACHE_TTL_WEATHER`	Weather cache TTL (seconds)	300
`CACHE_TTL_FINANCE`	Finance cache TTL (seconds)	60
`CACHE_TTL_NEWS`	News cache TTL (seconds)	600
`RATE_LIMIT_REQUESTS`	Rate limit requests	100
`RATE_LIMIT_WINDOW`	Rate limit window (ms)	60000

🧪 Testing

Run the test script:

npm test

Using MCP Inspector (Visual Testing)

# Install MCP Inspector globally
npm install -g @modelcontextprotocol/inspector

# Run the inspector
mcp-inspector node dist/index.js

This opens a web interface at http://localhost:5173 where you can:

See all available tools
Test tool calls interactively
View request/response logs

Manual STDIO Testing

# Start the server
node dist/index.js

# Run the test script
node dist/test-runner.js


## Testing Individual APIs

### Test Weather API

```bash
# Create a test file: test-weather.ts
import { getCurrentWeather, getWeatherForecast } from './src/api/weather.js';

async function testWeather() {
  try {
    console.log('Testing current weather...');
    const current = await getCurrentWeather('London');
    console.log('Current weather:', current);
    
    console.log('\nTesting forecast...');
    const forecast = await getWeatherForecast('Paris', 3);
    console.log('Forecast:', forecast);
  } catch (error) {
    console.error('Error:', error);
  }
}

testWeather();

Run:

npx tsx test-weather.ts

Test Finance API

import { getStockQuote, getCurrencyExchange } from './src/api/finance.js';

async function testFinance() {
  try {
    console.log('Testing stock quote...');
    const stock = await getStockQuote('AAPL');
    console.log('Stock:', stock);
    
    console.log('\nTesting currency exchange...');
    const exchange = await getCurrencyExchange('USD', 'EUR');
    console.log('Exchange:', exchange);
  } catch (error) {
    console.error('Error:', error);
  }
}

testFinance();

Test News API

# Create a test file: test-news.ts
import { getTopHeadlines, searchNews } from './src/api/news.js';

async function testNews() {
  try {
    console.log('Testing headlines...');
    const headlines = await getTopHeadlines('us', 'technology');
    console.log('Headlines:', headlines);
    
    console.log('\nTesting search...');
    const search = await searchNews('artificial intelligence');
    console.log('Search results:', search);
  } catch (error) {
    console.error('Error:', error);
  }
}

testNews();

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A bridge allowing AI/LLMs to seamlessly interact with external APIs for weather, finance, and news services through a standardized MCP-compliant interface.

Related MCP Servers

Customized MCP Server
MorvanZhou
-
security
A
license
-
quality
A server that integrates the MCP library with OpenAI's API, allowing users to interact with various tools, such as the weather tool, through natural language queries.
Last updated -
Python
MIT License
MCP-Weather Server
aaasoulmate
-
security
F
license
-
quality
An intermediate agent server that enhances LLMs with weather data capabilities using the Model Context Protocol (MCP) framework, enabling retrieval of real-time weather information.
Last updated -
Python
API Integration MCP Server
dianakrog
-
security
F
license
-
quality
Connects external APIs like Open-Meteo and AgroMonitoring to your development environment through URI-like requests, allowing access to live data directly in MCP-compatible tools.
Last updated -
JavaScript
mcp-weather
githubmilind
-
security
F
license
-
quality
A Model Context Protocol (MCP) server that enables AI assistants and LLMs to access real-time weather data and forecasts by connecting to the OpenWeatherMap API.
Last updated -
Python

View all related MCP servers

MCP Multi-API Server