MCP API with Express and Hexagonal Architecture

A simple Node.js API using Express that connects to multiple MCP (Model Context Protocol) servers. Built with hexagonal architecture for clean separation of concerns.

What it does

• Connects to various MCP servers
• Exposes REST endpoints for tools, resources, and prompts
• Uses ports and adapters pattern
• Includes Swagger docs for easy testing

Getting started

First, install the dependencies:

npm install

Then run the server:

npm start

The API will be available at http://localhost:3000, and you can check the docs at http://localhost:3000/api-docs.

Endpoints

• GET /servers - lists available servers
• GET /servers/{server}/tools - tools from a server
• POST /servers/{server}/tools/{toolName} - call a tool
• And more for resources and prompts

Configure your MCP servers in src/infrastructure/config/mcpServers.js