AI-Create-MCP (WIP)

_This project is a work in progress and not yet complete._

ai-create-mcp is a Go-based tool that converts OpenAPI Specification (OAS) files into a Model Context Protocol (MCP) program. It provides a simple and efficient way to generate MCP-compliant code or configurations from OAS files, with customizable options for project setup and integrations.

中文

Features

- Convert OAS files to MCP protocol.
- Customizable project name, directory, and version.
- Optional integration with Claude.app.
- Inspector tool for debugging and analysis.

Installation

To install the ai-create-mcp, ensure you have Go installed on your system. Then, run the following command:

go install github.com/xxlv/ai-create-mcp

Alternatively, clone the repository and build it manually:

git clone https://github.com/xxlv/ai-create-mcp.git
cd ai-create-mcp
go build

Usage

The tool is configured via command-line flags. Below is the list of available flags and their descriptions:

| Flag | Type | Default Value | Description |
| -------------- | ------ | -------------- | ------------------------------------- |
| -path | string | "" | Directory to create the project in |
| -name | string | "" | Project name |
| -oaspath | string | "" | Path to the OAS file |
| -version | string | "0.1.0" | Server version |
| -inspector | bool | true | Enable/disable the inspector tool |
| -description | string | "Simple mcp" | Project description |
| -claudeapp | bool | true | Enable/disable Claude.app integration |
| -autoyes | bool | true | Enable/disable auto-confirmation |

Example

To generate an MCP project from an OAS file, run:

ai-create-mcp -path ./myproject -name my-mcp-app -oaspath ./openapi.yaml -version 1.0.0

This command will:

- Create a project in the ./myproject directory.
- Name the project my-mcp-app.
- Use the OAS file located at ./openapi.yaml.
- Set the server version to 1.0.0.

> ./testdata/openapi.yml will be converted into the following tools🔧

> To disable the inspector and Claude.app integration, use:

ai-create-mcp -path ./myproject -name my-mcp-app -oaspath ./openapi.yaml -inspector=false -claudeapp=false

For a fully automated run (no prompts), enable -autoyes:

ai-create-mcp -path ./myproject -name my-mcp-app -oaspath ./openapi.yaml -autoyes

Configuration

The tool relies on the provided command-line flags for configuration. Ensure that:

- The -oaspath points to a valid OAS file (e.g., .yaml).
- The -path directory is writable.
- The -name adheres to valid naming conventions for your use case.

Contributing

Contributions are welcome! To contribute:

1. Fork the repository.
2. Create a new branch (git checkout -b feature/your-feature).
3. Make your changes and commit them (git commit -m "Add your feature").
4. Push to the branch (git push origin feature/your-feature).
5. Open a pull request.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Contact

For questions or support, please open an issue on the GitHub repository.