Mcp Server Generator

What is Mcp Server Generator about?

Mcp Server Generator streamlines the lifecycle of Model Context Protocol (MCP) servers used by Claude Desktop. It offers a command‑line workflow to create new servers, update existing ones, list server code, analyze required npm packages, and register the servers in Claude's configuration.

How to use Mcp Server Generator?

Clone the repository and install dependencies:

git clone https://github.com/SerhatUzbas/mcp-server-generator.git
cd mcprotocol
npm install

Register the creator server in Claude Desktop's claude_desktop_config.json (MacOS, Windows or via Claude settings). Example entry:

{
  "mcpServers": {
    "mcp-server-generator": {
      "command": "node",
      "args": ["/full/path/to/creator-server.js"]
    }
  }
}

Interact through Claude Desktop – select the MCP integration and ask Claude to create, list, or update servers using natural language prompts.
The tool will generate server code in the servers directory, update the Claude config, and optionally run npm install for any missing dependencies.

Key Features of Mcp Server Generator

Server scaffolding – createMcpServer generates boiler‑plate code for a new MCP server based on user specifications.
Update workflow – updateMcpServer modifies existing server implementations.
Dependency analysis & installation – analyzeServerDependencies identifies required npm packages; installServerDependencies installs them automatically.
Configuration helpers – getClaudeConfig and updateClaudeConfig simplify reading and writing Claude Desktop’s JSON config.
Direct execution testing – runServerDirectly runs a server to surface syntax or runtime errors before registration.
Server discovery – listServers and getServerContent allow quick inspection of all generated servers.

Use Cases of Mcp Server Generator

Rapid prototyping of custom integrations (e.g., database access, external APIs) for Claude Desktop.
Team collaboration where multiple developers can generate consistent MCP server templates.
Automated CI/CD pipelines that programmatically create or update MCP servers as part of deployment scripts.
Educational demos showing how to build and register MCP servers without manual configuration.

FAQ from the Mcp Server Generator

Q: Do I need to install a global package to run the generator? A: No. After cloning the repo, simply run npm install locally and use the provided scripts via node.

Q: Can I use the generator on Windows? A: Yes. Follow the Windows path syntax when editing claude_desktop_config.json (use double backslashes or escape them).

Q: What Node.js version is required? A: Node.js v16 or later.

Q: How are server files stored? A: Generated code is placed in the servers directory at the repository root.

Q: How do I add a new dependency after a server is created? A: Run the installServerDependencies tool or manually execute npm install <package> within the project.

A tool for creating and managing Model Context Protocol (MCP) servers for Claude Desktop.

Overview

The MCP Server Creator helps you create, manage, and register custom MCP servers with Claude Desktop. This tool provides an interface for:

Creating new MCP servers
Updating existing servers
Registering servers with Claude Desktop

Getting Started

Prerequisites

Node.js (v16 or later)
Claude Desktop installed

Installation

Clone this repository:

git clone https://github.com/SerhatUzbas/mcp-server-generator.git
cd mcprotocol

Install dependencies (only first installation):
```
npm install
```
Register the creator server with Claude Desktop:

Macos:

open ~/Library/"Application Support"/Claude/claude_desktop_config.json

Windows (Command Prompt):

start %APPDATA%\Claude\claude_desktop_config.json

Or from Claude Desktop: Settings > Developer > Edit Config

example:

{
  "mcpServers": {
    "mcp-server-generator": {
      "command": "node",
      "args": ["/Users/username/Documents/GitHub/mcprotocol/creator-server.js"]
    }
  }
}

Note for Windows users: Remember to use backslashes for file paths and escape them properly in your JSON configuration. Example:
{
  "mcpServers": {
    "mcp-server-generator": {
      "command": "node",
      "args": ["C:\\Users\\username\\Documents\\GitHub\\mcprotocol\\creator-server.js"]
    }
  }
}

Using the MCP Server Creator

Once registered, you can use the MCP Server Creator through Claude Desktop:

Open Claude Desktop
Select resources and prompts from choose an integration dropdown
Ask Claude to create or manage your MCP servers

Creating a New Server

Ask Claude to create a server for your specific needs:

Create an simple MCP server that integrates with PostgreSQL to provide database operations and query capabilities.

Claude will (probably):

Check the server list if it exist
Generate the server code
Save it to the servers directory
Register it with Claude Desktop
Identify and install required dependencies

Available Tools

The MCP Server Creator provides several tools for managing your servers:

listServers - List all available servers
getServerContent - View the code of an existing server
createMcpServer - Create a new server
updateMcpServer - Update an existing server
analyzeServerDependencies - Identify required npm packages
installServerDependencies - Install required packages
getClaudeConfig - View current Claude Desktop configuration
updateClaudeConfig - Update Claude Desktop configuration
runServerDirectly - Checks if any error appears when running

Troubleshooting

Server Not Appearing in Claude

Verify the server was registered correctly in the Claude Desktop config
Check for any JavaScript syntax errors in your server code
Restart Claude Desktop after registering new servers

Dependency Issues

If dependencies aren't installing correctly:

Try installing them manually: npm install [package-name]
Check for compatibility issues between packages
Ensure your Node.js version is compatible with the packages

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Mcp Server Generator