MCP Server Generator

What is mcp-server-generator?

mcp-server-generator is a tool designed to help users create, manage, and register custom Model Context Protocol (MCP) servers specifically for Claude Desktop. It aims to simplify the process of building custom JavaScript MCP servers, providing AI guidance, automatic dependency management, and seamless integration with Claude Desktop.

How to use mcp-server-generator?

To use mcp-server-generator, you first need to have Node.js (v16 or later) and Claude Desktop installed. After cloning the repository and installing dependencies, you need to register the creator server with Claude Desktop by modifying its configuration file (claude_desktop_config.json). Once registered, you can interact with the MCP Server Creator directly through Claude Desktop by asking Claude to create or manage your MCP servers. For example, you can prompt Claude to create a server for specific needs, such as integrating with PostgreSQL for database operations.

Key Features of mcp-server-generator

Server Creation and Management: Create new MCP servers, update existing ones, and register them with Claude Desktop.
AI Guidance: Leverage AI to assist in building custom JavaScript MCP servers.
Automatic Dependency Management: Identifies and installs required npm packages for your servers.
Claude Desktop Integration: Seamlessly integrates with Claude Desktop for server management and interaction.
Available Tools: Provides a suite of tools including listServers, getServerContent, createMcpServer, updateMcpServer, analyzeServerDependencies, installServerDependencies, getClaudeConfig, updateClaudeConfig, and runServerDirectly.

Use Cases of mcp-server-generator

Custom MCP Server Development: Developers can quickly build and deploy custom MCP servers tailored to specific functionalities.
Non-Technical User Empowerment: Non-technical users can create MCP servers with AI guidance, abstracting away complex coding.
Database Integration: Create MCP servers that integrate with databases like PostgreSQL for data operations.
Extending Claude Desktop Capabilities: Enhance Claude Desktop's functionalities by adding custom MCP servers.

FAQ from mcp-server-generator

Q: My server is not appearing in Claude Desktop. What should I do? A: Verify that the server was registered correctly in the Claude Desktop configuration. Check for any JavaScript syntax errors in your server code and restart Claude Desktop after registering new servers.

Q: I am facing dependency issues. How can I resolve them? A: Try installing dependencies manually using npm install [package-name]. Also, check for compatibility issues between packages and ensure your Node.js version is compatible with the packages you are trying to install.

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