MCP Simple Server

What is MCP Simple Server?

A simple server implementing the Model Context Protocol (MCP). It supports both HTTP (default port 3001) and stdio transport, and is intended for developers experimenting with the MCP protocol or building MCP clients.

How to use MCP Simple Server?

Install dependencies with npm install, then start the HTTP server with npm start or the stdio server with npm run stdio. Use npm run bridge to connect the MCP Inspector, npm run cli for an interactive CLI, or npm run client <query> for programmatic queries. Custom domain support is available via a hosts file setup script.

Key features of MCP Simple Server

• Implements the Model Context Protocol (MCP)
• Dual transport: HTTP/SSE and stdio
• Bridge mode for MCP Inspector compatibility
• Interactive CLI for search queries
• Sample client for programmatic use
• Custom domain support via hosts file mapping
• Environment variable configuration (PORT, DOMAIN_NAME, SERVER_IP)

Use cases of MCP Simple Server

• Testing MCP tool and resource integrations locally
• Developing and debugging MCP clients over stdio
• Demonstrating MCP server setup and communication patterns
• Using MCP Inspector to inspect server messages

FAQ from MCP Simple Server

What is the default port?

The default port is 3001.

How do I run the stdio server?

Run npm run stdio.

How can I use the MCP Inspector with the stdio server?

Run npm run bridge to start an HTTP server on port 3001 that forwards JSON‑RPC requests to the stdio server.

What environment variables are available?

PORT, DOMAIN_NAME, and SERVER_IP.

How is the custom domain configured?

By editing the hosts file and mapping mcp.local to 127.0.0.1, either manually or with the sudo ./hosts-setup.sh script.