What Is MCP, Really? A Real Server, Tested Against the Actual Protocol

说明与用途

MCP 允许将工具作为服务器公开，任何兼容 MCP 的客户端都可以使用，无需额外集成代码。文章展示了一个天气服务器，并在真实协议下进行测试，同时修复了顶层 await 问题。

问题

Tools were duplicated across projects, requiring manual sync of function, schema, and description.

结果

The MCP server correctly lists tools and returns weather data for Dhaka, demonstrating that the protocol works in a real subprocess environment.

工作流

• Define weather data and create an MCP server with a get_weather tool.
• Register the tool with title, description, and Zod input schema.
• Wrap server startup in an async main() to support top‑level await.
• Spawn the server as a subprocess via StdioServerTransport.
• Create an MCP client with StdioClientTransport pointing to the server process.
• List available tools and call get_weather with a city argument.
• Close the client connection.

证据

Every tool in this series so far was wired directly into one project. Fine once — until a second project wants the same tool, and you're copying the function, schema, and description, keeping both in sync by hand.

来源

Anthropic introduced MCP in November 2024. OpenAI and Google both adopted it within months. In December 2025, Anthropic donated the protocol to the Agentic AI Foundation, a vendor-neutral Linux Foundation project co-founded with Block and OpenAI.

来源

Same name, same description, same one field as the get_weather tool from the tool-calling post — inputSchema just takes Zod validators instead of hand-written JSON Schema, and the SDK converts it.

来源

This spawns the server as a real subprocess and does the actual MCP handshake — not a mock.

来源

The first version ended with a bare top-level await server.connect(transport). Type-checked fine. The client connection closed immediately on run. The cause: this file's execution transforms it to a module format that doesn't support top-level await, crashing the process before the server could listen — nothing to do with MCP itself, but exactly where an MCP server's entrypoint sits. Wrapping it in an async main() fixed it completely.

来源