# MCP Server Creator

A specialized Model Context Protocol (MCP) server designed to help you easily create new MCP servers. This server provides documentation, templates, and tools to streamline the process of creating and configuring MCP servers for Claude Desktop.

## Features

- 📚 Documentation resource with MCP key concepts
- 🛠️ Complete server setup guide
- 🚀 File generation tool that creates all necessary files
- ⚙️ Ready-to-use Claude Desktop configuration
- 📝 Interactive prompts for guided server creation

## Installation

1. Clone the repository:
```bash
git clone https://github.com/SterlingChin/mcp-builder.git
cd mcp-builder
```

2. Install dependencies:
```bash
npm install
```

3. Build the server:
```bash
npm run build
```

## Usage

### As an MCP Server

Configure this server in your Claude Desktop configuration file at `~/.claude-config.json`:

```json
{
  "mcpServers": {
    "mcp-creator": {
      "command": "node",
      "args": [
        "/path/to/mcp-builder/build/index.js"
      ]
    }
  }
}
```

Replace `/path/to/mcp-builder` with the actual path to this project.

### In Claude Desktop

Once configured, you can interact with this server in Claude by:

1. **Accessing documentation:**
   ```
   Show me the MCP documentation from mcp://docs
   ```

2. **Getting setup guides:**
   ```
   Use the get-mcp-docs tool to show me how to set up an MCP server
   ```

3. **Generating a complete MCP server:**
   ```
   Use the generate-mcp-server tool to create a server called "weather-server"
   that provides weather information
   ```

## Server Capabilities

### Resources
- `mcp://docs` - Comprehensive MCP documentation and key concepts

### Tools
- `get-mcp-docs` - Retrieve documentation about the Model Context Protocol
- `generate-mcp-server` - Generate complete MCP server setup with all necessary files

### Prompts
- `mcp-setup` - Interactive prompt template for guided server creation

## Development

### Prerequisites
- Node.js 18+
- TypeScript
- npm or yarn

### Setup
1. Fork and clone the repository
2. Install dependencies: `npm install`
3. Make your changes to `index.ts`
4. Build: `npm run build`
5. Test: `npm start`

### Contributing
We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.

### Project Structure
```
mcp-builder/
├── index.ts          # Main server implementation
├── build/            # Compiled JavaScript output
├── package.json      # Dependencies and scripts
├── tsconfig.json     # TypeScript configuration
├── LICENSE           # MIT license
└── README.md         # This file
```

## Examples

### Creating a Simple Server
Ask Claude: "Generate an MCP server called 'todo-manager' that helps manage todo lists"

### Getting Documentation
Ask Claude: "Show me the MCP setup documentation"

### Using Resources
Ask Claude: "What's in the mcp://docs resource?"

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## Support

- 📖 [MCP Documentation](https://github.com/modelcontextprotocol/typescript-sdk)
- 💬 [Create an issue](https://github.com/SterlingChin/mcp-builder/issues)
- 🔧 [Contributing Guidelines](CONTRIBUTING.md)

---

Built with ❤️ for the Model Context Protocol ecosystem