mcp-builder

Use the MCP TypeScript SDK's McpServer class and registerTool method with Zod schemas for input validation. Define title, description, inputSchema, and annotations for each tool, then connect via StdioServerTransport for local use or StreamableHTTPServerTransport for remote deployment.

Create an XML evaluation file with 10 complex, read-only questions and verifiable answers, then run the evaluation.py script against your server via stdio, SSE, or HTTP transport. The script uses Claude to attempt each question and reports accuracy, tool call counts, and per-task feedback.

Use stdio for local integrations and command-line tools where the server runs as a subprocess of a single client. Use streamable HTTP for remote servers, web services, and multi-client scenarios; SSE is deprecated in favor of streamable HTTP.

Use snake_case with a service prefix like github_create_issue to avoid conflicts when multiple servers are used together. Descriptions should precisely state functionality, document parameters and return schemas, and include annotations such as readOnlyHint and destructiveHint.

Questions must be independent, read-only, non-destructive, and complex enough to require multiple tool calls. Answers must be single verifiable values that remain stable over time, checked via direct string comparison.