Generate dual-mode MCP servers with best practices
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"hitoshura25-mcp-server-generator","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# MCP Server Generator > A meta-generator for creating dual-mode MCP servers with best practices [](https://www.python.org/downloads/) [](https://opensource.org/licenses/Apache-2.0) ## Overview Generate complete, production-ready MCP (Model Context Protocol) servers that work in two modes: - **MCP Server Mode**: For AI agents (Claude Desktop, etc.) - **CLI Mode**: For developers **This tool is itself an MCP server**, enabling AI agents to generate other MCP servers! It demonstrates the dual-mode architecture pattern it creates and implements progressive disclosure for context-efficient tool discovery. ## Why Use This? - ⚡ **Fast**: Generate a complete MCP server in under 5 minutes - 🏗️ **Complete**: Includes tests, documentation, packaging, and CI/CD - ✅ **Tested**: Generated servers have comprehensive test suites with high coverage - 🎯 **Best Practices**: Follows validated patterns from production MCP servers with built-in guidance - 🔧 **Dual-Mode**: Works as both MCP server and CLI tool - 🧠 **Smart Discovery**: Progressive disclosure tools for context-efficient AI agent usage - 📦 **Ready to Publish**: GitHub Actions workflows included for PyPI publishing ## Features - ✅ **Dual-mode architecture** (MCP + CLI) - ✅ **Progressive disclosure tools** (context-efficient tool discovery for AI agents) - ✅ **Built-in guidance** (best practices and implementation guides) - ✅ **Claude Code integration** (generate slash commands for guided development) - ✅ **Async/await support** (async handlers for I/O operations, avoids event loop errors) - ✅ **Package prefix support** (avoid PyPI namespace conflicts with AUTO detection) - ✅ **Complete project scaffolding** (tests, docs, packaging) - ✅ **GitHub Actions workflows** (via pypi-workflow-generator) - ✅ **Comprehensive test suite** (92+ tests with high coverage) - ✅ **Type hint…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.