building-mcp-serverslisted

# MCP Server Development Guide ## Overview Create MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. The quality of an MCP server is measured by how well it enables LLMs to accomplish real-world tasks. --- ## High-Level Workflow Creating a high-quality MCP server involves four main phases: ### Phase 1: Deep Research and Planning #### 1.1 Understand Modern MCP Design **API Coverage vs. Workflow Tools:** Balance comprehensive API endpoint coverage with specialized workflow tools. When uncertain, prioritize comprehensive API coverage. **Tool Naming and Discoverability:** Use consistent prefixes (e.g., `github_create_issue`, `github_list_repos`) and action-oriented naming. **Context Management:** Design tools that return focused, relevant data. Support filtering/pagination. **Actionable Error Messages:** Error messages should guide agents toward solutions with specific suggestions. #### 1.2 Study MCP Protocol Documentation Start with the sitemap: `https://modelcontextprotocol.io/sitemap.xml` Fetch pages with `.md` suffix (e.g., `https://modelcontextprotocol.io/specification/draft.md`). Key pages: Specification overview, transport mechanisms, tool/resource/prompt definitions. #### 1.3 Study Framework Documentation **Recommended stack:** - **Language**: TypeScript (high-quality SDK, good AI code generation) - **Transport**: Streamable HTTP for remote servers,