{"_id":"@conveniencepro/ctp-mcp-server","_rev":"2-256b83eeaf301baaf7f365dcdcdc0e77","name":"@conveniencepro/ctp-mcp-server","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@conveniencepro/ctp-mcp-server","version":"1.0.0","keywords":["mcp","model-context-protocol","ctp","tool-generation","ai","developer-tools","claude","code-generation","scaffolding"],"author":{"name":"ConveniencePro"},"license":"MIT","_id":"@conveniencepro/ctp-mcp-server@1.0.0","maintainers":[{"name":"convenienceprouser","email":"welovegoodhouse@gmail.com"}],"homepage":"https://github.com/titan-alpha/ctp-mcp-server","bugs":{"url":"https://github.com/titan-alpha/ctp-mcp-server/issues"},"bin":{"ctp-mcp-server":"dist/index.js"},"dist":{"shasum":"0812b5ecd4bed25bc98fb4be07f0ac69b882ae72","tarball":"https://registry.npmjs.org/@conveniencepro/ctp-mcp-server/-/ctp-mcp-server-1.0.0.tgz","fileCount":58,"integrity":"sha512-wfmB/NwVk08Ib8vt9+K67eDivj5CTO+51BX4Xpfn9h0gayFvMtc1THI3Lzu73j/nynKYM6WWL84y1yZxOAF3Dg==","signatures":[{"sig":"MEUCIE/KdY9xOKx4SL1rPsEM6CQ00v3wbFuiPz6CmmjPJKOFAiEA2B8YO1hsBkh2rG/+gUQ/GgwgQvmz5NlEesi7qxwcduQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":97598},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"66a29192eef5460eff5df11076bf7cdd4c069963","scripts":{"dev":"tsc --watch","test":"node examples/test-tool-creation.js","build":"tsc && cp -r src/templates dist/ && chmod +x dist/index.js","clean":"rm -rf dist","start":"node dist/index.js"},"_npmUser":{"name":"convenienceprouser","email":"welovegoodhouse@gmail.com"},"repository":{"url":"git+https://github.com/titan-alpha/ctp-mcp-server.git","type":"git"},"_npmVersion":"11.6.2","description":"MCP server for AI-powered CTP tool generation - describe a tool, get production-ready code","directories":{},"_nodeVersion":"25.1.0","dependencies":{"handlebars":"^4.7.8","@conveniencepro/ctp-core":"^1.0.0","@modelcontextprotocol/sdk":"^0.6.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/ctp-mcp-server_1.0.0_1764827060838_0.03495025709723287","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@conveniencepro/ctp-mcp-server","version":"1.0.1","description":"MCP server for AI-powered CTP tool generation - describe a tool, get production-ready code","main":"dist/index.js","type":"module","bin":{"ctp-mcp-server":"dist/index.js"},"scripts":{"build":"tsc && cp -r src/templates dist/ && chmod +x dist/index.js","dev":"tsc --watch","start":"node dist/index.js","test":"node examples/test-tool-creation.js","clean":"rm -rf dist"},"keywords":["mcp","model-context-protocol","ctp","tool-generation","ai","developer-tools","claude","code-generation","scaffolding"],"author":{"name":"ConveniencePro"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/titan-alpha/ctp-mcp-server.git"},"homepage":"https://github.com/titan-alpha/ctp-mcp-server","bugs":{"url":"https://github.com/titan-alpha/ctp-mcp-server/issues"},"dependencies":{"@conveniencepro/ctp-core":"^1.0.0","@modelcontextprotocol/sdk":"^0.6.0","handlebars":"^4.7.8"},"devDependencies":{"@types/node":"^20.0.0","typescript":"^5.3.0"},"engines":{"node":">=18.0.0"},"gitHead":"66a29192eef5460eff5df11076bf7cdd4c069963","types":"./dist/index.d.ts","_id":"@conveniencepro/ctp-mcp-server@1.0.1","_nodeVersion":"25.1.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-Kw62cFFQ4eOlEwQL4WgoCI8C/n4tokLmg8YISJ4JErEU+XT6fJCzlMw9EdzrLaN5KVTb1mVTONQ6kNGoASY1Qw==","shasum":"af76ab35c1617b83e0f50bb1f503cdc3e29613df","tarball":"https://registry.npmjs.org/@conveniencepro/ctp-mcp-server/-/ctp-mcp-server-1.0.1.tgz","fileCount":58,"unpackedSize":97602,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCils62TiBGST9wf+igpOWXzmlyZ37yIy1EWQ2/fZwPVQIhANYvlQdKpHVDbe6CBL5k9ptnNNuiW2MsYAKpp+xW62Vq"}]},"_npmUser":{"name":"convenienceprouser","email":"welovegoodhouse@gmail.com"},"directories":{},"maintainers":[{"name":"convenienceprouser","email":"welovegoodhouse@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/ctp-mcp-server_1.0.1_1764827175594_0.12803283908530672"},"_hasShrinkwrap":false}},"time":{"created":"2025-12-04T05:44:20.793Z","modified":"2025-12-04T05:46:15.971Z","1.0.0":"2025-12-04T05:44:20.978Z","1.0.1":"2025-12-04T05:46:15.738Z"},"bugs":{"url":"https://github.com/titan-alpha/ctp-mcp-server/issues"},"author":{"name":"ConveniencePro"},"license":"MIT","homepage":"https://github.com/titan-alpha/ctp-mcp-server","keywords":["mcp","model-context-protocol","ctp","tool-generation","ai","developer-tools","claude","code-generation","scaffolding"],"repository":{"type":"git","url":"git+https://github.com/titan-alpha/ctp-mcp-server.git"},"description":"MCP server for AI-powered CTP tool generation - describe a tool, get production-ready code","maintainers":[{"name":"convenienceprouser","email":"welovegoodhouse@gmail.com"}],"readme":"# CTP MCP Server\n\nMCP server for AI-powered CTP tool generation - describe a tool, get production-ready code.\n\n## Overview\n\nThe CTP MCP Server is a [Model Context Protocol](https://modelcontextprotocol.io) server that helps developers create [ConveniencePro Tool Protocol](https://github.com/titan-alpha/ctp) (CTP) tools quickly and easily. Simply describe what tool you want to build, and the MCP server generates complete, production-ready code including:\n\n- Tool definitions following the CTP specification\n- Implementation code (client-side or server-side)\n- Complete test suites\n- TypeScript types and validation\n\n## Features\n\n- **AI-Powered Generation**: Describe your tool in natural language\n- **Complete Scaffolding**: Get definition, implementation, and tests\n- **CTP Validation**: Ensures generated tools follow the specification\n- **Duplicate Detection**: Checks for similar existing tools\n- **Template-Based**: Consistent, best-practice code generation\n- **Type-Safe**: Full TypeScript support\n\n## Installation\n\n```bash\nnpm install -g @conveniencepro/ctp-mcp-server\n```\n\nOr use directly with npx:\n\n```bash\nnpx @conveniencepro/ctp-mcp-server\n```\n\n## Usage with Claude Desktop\n\nAdd to your Claude Desktop configuration (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):\n\n```json\n{\n  \"mcpServers\": {\n    \"ctp-tools\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@conveniencepro/ctp-mcp-server\"]\n    }\n  }\n}\n```\n\n## Available Tools\n\n### `ctp_create_tool`\n\nGenerate a complete CTP tool from a natural language description.\n\n**Parameters:**\n- `description` (required): Natural language description of what the tool should do\n- `name` (optional): Tool name (auto-generated if not provided)\n- `category` (optional): Tool category\n- `executionMode` (optional): Where the tool runs (`client`, `server`, or `both`)\n\n**Example:**\n```\nCreate a tool that converts YAML to JSON\n```\n\n### `ctp_validate_tool`\n\nValidate a tool definition against the CTP specification.\n\n**Parameters:**\n- `definition` (required): The tool definition object to validate\n\n### `ctp_generate_implementation`\n\nGenerate implementation code from a tool definition.\n\n**Parameters:**\n- `definition` (required): The tool definition\n- `executionMode` (optional): Execution mode (`client` or `server`)\n\n### `ctp_generate_tests`\n\nGenerate a test suite for a CTP tool.\n\n**Parameters:**\n- `definition` (required): The tool definition\n- `implementation` (optional): The tool implementation code\n\n### `ctp_search_duplicates`\n\nSearch for existing tools with similar functionality.\n\n**Parameters:**\n- `description` (required): Description of the tool to search for\n- `category` (optional): Category to narrow search\n\n## Example Workflow\n\n1. **Search for duplicates:**\n   ```\n   Use ctp_search_duplicates to check if a \"markdown to HTML converter\" already exists\n   ```\n\n2. **Generate the tool:**\n   ```\n   Use ctp_create_tool with description: \"Convert Markdown text to HTML\"\n   ```\n\n3. **Review generated files:**\n   - `src/tools/markdown-to-html-definition.ts` - Tool definition\n   - `src/tools/markdown-to-html.ts` - Implementation\n   - `src/tools/__tests__/markdown-to-html.test.ts` - Tests\n\n4. **Implement the logic:**\n   Replace the placeholder implementation with actual logic\n\n5. **Test and deploy:**\n   ```bash\n   npm test\n   npm run build\n   ```\n\n## Generated Code Structure\n\n```typescript\n// Tool Definition\nexport const markdownToHtmlDefinition: ToolDefinition = {\n  id: 'markdown-to-html',\n  name: 'Markdown to HTML',\n  description: 'Convert Markdown text to HTML',\n  category: 'converters',\n  // ... full specification\n};\n\n// Implementation\nexport const markdownToHtmlFn: ToolFunction<MarkdownToHtmlResult> = (params) => {\n  // Your implementation here\n};\n\n// Tests\ndescribe('Markdown to HTML', () => {\n  it('should convert markdown to HTML', () => {\n    // Generated tests\n  });\n});\n```\n\n## Development\n\n```bash\n# Clone the repository\ngit clone https://github.com/titan-alpha/ctp-mcp-server.git\ncd ctp-mcp-server\n\n# Install dependencies\nnpm install\n\n# Build\nnpm run build\n\n# Run locally\nnpm start\n```\n\n## Architecture\n\n```\nctp-mcp-server/\n├── src/\n│   ├── index.ts              # MCP server entry point\n│   ├── tools/                # MCP tool implementations\n│   │   ├── create-tool.ts    # Tool scaffolding\n│   │   ├── validate-tool.ts  # Validation\n│   │   ├── generate-*.ts     # Code generators\n│   │   └── search-*.ts       # Duplicate detection\n│   ├── templates/            # Handlebars templates\n│   │   ├── tool-definition.hbs\n│   │   ├── client-implementation.hbs\n│   │   └── test-suite.hbs\n│   └── utils/                # Utilities\n│       ├── template-engine.ts\n│       ├── string-utils.ts\n│       └── ai-analyzer.ts\n└── dist/                     # Compiled output\n```\n\n## Contributing\n\nContributions are welcome! Please see the [CTP repository](https://github.com/titan-alpha/ctp) for contribution guidelines.\n\n## License\n\nMIT\n\n## Links\n\n- [CTP Specification](https://spec.conveniencepro.cc)\n- [CTP Repository](https://github.com/titan-alpha/ctp)\n- [Model Context Protocol](https://modelcontextprotocol.io)\n- [Issues](https://github.com/titan-alpha/ctp-mcp-server/issues)\n\n## Related Packages\n\n- [@conveniencepro/ctp-core](https://www.npmjs.com/package/@conveniencepro/ctp-core) - Core types and validation\n- [@conveniencepro/ctp-runtime](https://www.npmjs.com/package/@conveniencepro/ctp-runtime) - Execution runtime\n- [@conveniencepro/ctp-sdk](https://www.npmjs.com/package/@conveniencepro/ctp-sdk) - Embeddable SDK\n- [@conveniencepro/ctp-examples](https://www.npmjs.com/package/@conveniencepro/ctp-examples) - Example tools\n","readmeFilename":"README.md"}