MCP Express Server

What is MCP Express Server?

MCP Express Server is a Model Context Protocol (MCP) server built with Node.js, Express, and TypeScript. It implements MCP tools, resources, and prompts, and supports both StdioServerTransport for command-line usage and an Express HTTP server for testing and debugging.

How to use MCP Express Server?

Install dependencies with npm install, build the TypeScript code with npm run build, then run with npm start for StdioServerTransport or npm run dev for the Express server. To integrate with Cursor, add the server configuration to ~/.cursor/mcp.json specifying the command and path to the built index.js.

Key features of MCP Express Server

• Implements MCP tools, resources, and prompts
• Supports StdioServerTransport for MCP clients
• Includes an Express HTTP server for testing
• Provides built-in tools: echo and getCurrentTime
• Offers a sample resource (example://resource) and greeting prompt
• Written in TypeScript for type safety

Use cases of MCP Express Server

• Testing and debugging MCP server implementations locally
• Integrating with MCP-compatible clients like Cursor
• Learning how to build a minimal MCP server with Node.js
• Prototyping custom MCP tools, resources, or prompts

FAQ from MCP Express Server

What transports does MCP Express Server support?

It supports StdioServerTransport for command-line usage and an Express HTTP server for testing and debugging.

What tools are available in MCP Express Server?

Two tools are provided: echo (echoes back a message) and getCurrentTime (returns the current time in ISO format).

How do I add this server to Cursor?

Add a configuration entry to ~/.cursor/mcp.json with the command node and arguments pointing to the built dist/index.js file.

How can I test the MCP Express Server?

Run the Express server with npm run dev and access health check at http://localhost:3000/health or server info at http://localhost:3000/info.

What are the prerequisites for running MCP Express Server?

Node.js and npm are required. Dependencies are installed via npm install, and TypeScript compilation is done with npm run build.