AutoMCP

What is AutoMCP?

AutoMCP is a code generator for the Model Context Protocol (MCP) that automatically creates server and client code from YAML service definitions. It is intended for developers who want to quickly scaffold MCP-compatible services and clients.

How to use AutoMCP?

Clone the repository and install dependencies (Node.js 18+ required). Define a service in a YAML file inside the services/[service-name]/ directory, then run ./bin/automcp.sh generate to produce server code, client code, and handler stubs. Implement the tool logic in the generated handler files. Use the generated client to connect to the server and call tools.

Key features of AutoMCP

• Generates MCP-compatible server code from YAML definitions
• Generates client libraries for easy service consumption
• Creates handler stubs for implementing tool functionality
• Organizes code by service in dedicated directories

Use cases of AutoMCP

• Rapidly prototyping MCP services without writing boilerplate
• Generating consistent client libraries for internal or external consumers
• Scaffolding tool handler implementations to fill in later
• Maintaining a single source of truth (YAML) for service definitions

FAQ from AutoMCP

What does AutoMCP generate?

It generates server code, client code, and handler stubs from a YAML service definition. The output is placed in the generated/ and src/custom/ directories.

What are the runtime requirements?

Node.js 18 or higher and npm or yarn are required.

Is AutoMCP production-ready?

No. The README states this is a work in progress and that artifacts will be removed before final packaging for npm, PyPI, etc.

How do I define a service?

Create a YAML file in services/[service-name]/ following the provided schema that includes the service name, version, description, and a list of tools with parameters and return types.

How can I test the generated service?

Use the test script ./bin/test-service.sh [service-name] to verify the functionality of your services.