Make Your First MCP Server

创建您的第一个MCP服务器

这个仓库包含一个30分钟的演示和代码跟随教程，旨在引导专注于Android开发的开发者构建他们的第一个（应用/项目） 模型上下文协议 (MCP) 服务器。该工作坊使用免费的Cat Facts API和基于Python的MCP服务器，来演示如何构建工具框架、集成公共API，并与GitHub Copilot一起进行现场演示彩排。

内容

• docs/presentation_plan.md – 受众定义、学习目标和演示流程。
• docs/api_research.md – 猫咪趣事API的研究笔记、示例端点和JSON响应。
• docs/ide_setup.md – Android Studio/IntelliJ 设置检查清单，包括 Copilot 和 HTTP 客户端配置。
• docs/demo_script.md – 演讲中实时编码部分的逐分钟脚本。
• docs/supporting_materials.md – 演示文稿大纲、故障排除技巧以及参与者收获要点。
• docs/rehearsal_checklist.md – 全面检查清单，涵盖时间安排、提示词以及备用策略。
• src/catfacts_mcp/ – Python MCP服务器实现。
• tests/ – 验证Cat Facts HTTP客户端的模拟测试。

快速入门

1. 创建一个虚拟环境 并安装依赖项：

   python -m venv .venv
   source .venv/bin/activate
   pip install -e .[dev]

1. 运行测试 （使用模拟的HTTP响应）：

   pytest -q

1. 启动MCP服务器 本地（stdio 传输）：

   python -m catfacts_mcp.server

1. 呼叫 cat_fact 工具 从一个MCP兼容的客户端（例如，Claude Desktop）获取一个随机事实。

注： 用于自动化测试的执行沙盒不允许进行出站HTTP调用。在正式上线前，请务必在您的演示机器上验证Cat Facts API的访问情况。

现场演示亮点

• 展示如何使用GitHub Copilot来快速搭建FastMCP服务器和HTTP客户端。
• 使用IDE的HTTP客户端草稿文件检查真实的API响应。
• 演示通过标准输入输出（stdio）运行服务器，并讨论如何与支持MCP（可能是指某种配置或协议意识）的编辑器进行集成。
• 分享故障排除策略及后续步骤，供参会者继续构建MCP工具。