Which integrations are available for this server?

Used for configuration management, allowing the server to load API keys and other environment variables from a .env file Version control system used for cloning the repository Platform hosting the repository that needs to be cloned during installation Required runtime environment for the MCP server, version 18+ needed to run the application Package manager used for installing dependencies and running scripts for the MCP server Programming language used for implementing the server with type safety Alternative package manager that can be used instead of npm for dependency management

How do I use MCP Multi-API Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@MCP Multi-API Server get weather in Tokyo and stock price for Tesla" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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

Related MCP server: MCP-Weather Server

📋 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();

MCP Multi-API Server