# 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:
  - [OpenWeatherMap](https://openweathermap.org/api)
  - [Alpha Vantage](https://www.alphavantage.co/support/#api-key)
  - [NewsAPI](https://newsapi.org/register)

## 🛠️ Installation

1. Clone the repository:
```bash
git clone https://github.com/yourusername/mcp-multi-api-server.git
cd mcp-multi-api-server
```

2. Install dependencies:
```bash
npm install
```

3. Copy the environment template and add your API keys:
```bash
cp .env.example .env
```

4. Edit `.env` and add your API keys:
```env
OPENWEATHER_API_KEY=your_key_here
ALPHA_VANTAGE_API_KEY=your_key_here
NEWS_API_KEY=your_key_here
```

5. Build the project:
```bash
npm run build
```

## 🚀 Usage

### Starting the Server

```bash
npm start
```

For development with auto-reload:
```bash
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:
```bash
npm test
```

### Using MCP Inspector (Visual Testing)

```bash
# 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

```bash
# 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:
```bash
npx tsx test-weather.ts
```

### Test Finance API

```bash
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

```bash
# 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();