Used in examples for tool generation, such as converting Markdown text to HTML.
Generates production-ready TypeScript tool definitions, implementations, and test suites following the CTP specification with full type safety.
Used in examples for tool generation, such as converting YAML to JSON format.
CTP MCP Server
MCP server for AI-powered CTP tool generation - describe a tool, get production-ready code.
Overview
The CTP MCP Server is a Model Context Protocol server that helps developers create ConveniencePro Tool Protocol (CTP) tools quickly and easily. Simply describe what tool you want to build, and the MCP server generates complete, production-ready code including:
Tool definitions following the CTP specification
Implementation code (client-side or server-side)
Complete test suites
TypeScript types and validation
Features
AI-Powered Generation: Describe your tool in natural language
Complete Scaffolding: Get definition, implementation, and tests
CTP Validation: Ensures generated tools follow the specification
Duplicate Detection: Checks for similar existing tools
Template-Based: Consistent, best-practice code generation
Type-Safe: Full TypeScript support
Installation
Or use directly with npx:
Usage with Claude Desktop
Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
Available Tools
ctp_create_tool
Generate a complete CTP tool from a natural language description.
Parameters:
description(required): Natural language description of what the tool should doname(optional): Tool name (auto-generated if not provided)category(optional): Tool categoryexecutionMode(optional): Where the tool runs (client,server, orboth)
Example:
ctp_validate_tool
Validate a tool definition against the CTP specification.
Parameters:
definition(required): The tool definition object to validate
ctp_generate_implementation
Generate implementation code from a tool definition.
Parameters:
definition(required): The tool definitionexecutionMode(optional): Execution mode (clientorserver)
ctp_generate_tests
Generate a test suite for a CTP tool.
Parameters:
definition(required): The tool definitionimplementation(optional): The tool implementation code
ctp_search_duplicates
Search for existing tools with similar functionality.
Parameters:
description(required): Description of the tool to search forcategory(optional): Category to narrow search
Example Workflow
Search for duplicates:
Use ctp_search_duplicates to check if a "markdown to HTML converter" already existsGenerate the tool:
Use ctp_create_tool with description: "Convert Markdown text to HTML"Review generated files:
src/tools/markdown-to-html-definition.ts- Tool definitionsrc/tools/markdown-to-html.ts- Implementationsrc/tools/__tests__/markdown-to-html.test.ts- Tests
Implement the logic: Replace the placeholder implementation with actual logic
Test and deploy:
npm test npm run build
Generated Code Structure
Development
Architecture
Contributing
Contributions are welcome! Please see the CTP repository for contribution guidelines.
License
MIT
Links
Related Packages
@conveniencepro/ctp-core - Core types and validation
@conveniencepro/ctp-runtime - Execution runtime
@conveniencepro/ctp-sdk - Embeddable SDK
@conveniencepro/ctp-examples - Example tools