TestMcpServer

What is TestMcpServer?

TestMcpServer is an example MCP (Model Context Protocol) server implementation using Anthropic’s open‑source Model Context Protocol. It is designed to be more readable and easier to understand than existing examples, serving as a clean foundation for building custom MCP server projects. It targets developers who want to learn or quickly prototype MCP tools.

How to use TestMcpServer?

Clone the repository, run npm install, then build with npm run build. Run the server with node build/index.js. For development, use npm run dev to watch for changes, rebuild, and launch the MCP inspector at localhost:5173. To use TestMcpServer with Cursor, add a new MCP server with type command and set the server URL to node <absolute-path-to-project>\build\index.js.

Key features of TestMcpServer

• Clear, modular tool architecture (definitions, controllers, registry)
• Easy addition of new tools via a four‑step guide
• Built‑in error handling and error responses
• Development mode with hot‑reload and built‑in inspector
• Lowercase tool naming and PascalCase handler conventions

Use cases of TestMcpServer

• Learning how to structure a clean MCP server from a readable example
• Quickly prototyping and testing new MCP tools locally
• Building a foundation for a custom MCP server with multiple tool categories

FAQ from TestMcpServer

What are the dependencies required to run TestMcpServer?

Node, npm, and TypeScript are required.

How do I add a new tool to TestMcpServer?

Create a tool definition in /src/definitions/, add it to the category’s main.ts, implement a handler method in the corresponding controller in /src/controllers/, and register the handler in the controllerMap in /src/utils/toolRegistry.ts.

How can I run TestMcpServer locally for testing?

Build the project with npm run build, then execute node build/index.js. For an interactive development loop, use npm run dev to watch for changes and automatically rebuild and launch the inspector.

How do I connect TestMcpServer to Cursor?

In Cursor’s settings under Features → MCP Servers, click “Add new MCP server”, give it a name, set type to command, and enter node <absolute-path-to-project>\build\index.js as the command.