MCP Server

What is MCP Server?

MCP Server is an MCP server that scaffolds a new MCP server project using Bun. It integrates with Claude Desktop, which acts both as the MCP client and the host for the server. The generated sample project follows the same structure and includes an example tool for summing two numbers.

How to use MCP Server?

After installing Bun and Claude Desktop, clone the repository, run bun install, and build with bun run build. Configure Claude Desktop by editing its config file to point to the built build/main.js. Then ask Claude to "create a new mcp project" and specify a name; the server creates the project in a predefined location. If the project already exists, it prompts the user for a follow-up action.

Key features of MCP Server

• Scaffolds a new MCP server project using Bun.
• Integrates seamlessly with Claude Desktop as both client and host.
• Automatically registers new tools without additional configuration.
• Handles existing project directories gracefully.
• Built with Bun for fast setup and execution.
• Includes test coverage analysis with lcov reports.

Use cases of MCP Server

• Quickly bootstrap a new MCP server project for integration with Claude Desktop.
• Learn the MCP project structure by examining the generated sample.
• Develop custom MCP tools by following the existing tool pattern.
• Validate project integrity and test coverage during development.

FAQ from MCP Server

What are the prerequisites for using MCP Server?

Bun must be installed on your system, and Claude Desktop should be installed to act as the MCP client that launches the server.

How do I set up MCP Server with Claude Desktop?

Edit the claude_desktop_config.json file to add an entry for "create-mcp-app-bun" with command: "bun" and args: ["run", "<path_to_project>/build/main.js"]. Restart Claude Desktop for the change to take effect.

What happens if the target project directory already exists?

MCP Server detects the existing directory and prompts the user to specify the appropriate follow-up action rather than failing silently.

How can I add a new tool to MCP Server?

Create a new module in ./src/tools that extends AbstractTool and implements ITool, then implement the required methods (getName, getDescription, getInputSchema, validateWithDefaults, processToolWorkflow). The tool is automatically registered upon server restart.

How do I run test coverage on MCP Server?

Run bun run test:coverage for basic coverage. For advanced analysis with lcov, use bun run test:coverage:lcov and optionally generate an HTML report with genhtml.