MCP Researcher

🧮 MCP服务器课程

 __  __  ____ ____     ____ ___  _   _ ____  ____  _____
|  \/  |/ ___|  _ \   / ___/ _ \| | | |  _ \/ ___|| ____|
| |\/| | |   | |_) | | |  | | | | | | | |_) \___ \|  _|
| |  | | |___|  __/  | |__| |_| | |_| |  _ < ___) | |___
|_|  |_|\____|_|      \____\___/ \___/|_| \_\____/|_____|

         Learn to build MCP servers fast & reliably

作者：肯·凯 👨‍💻

厌倦了与MCP服务器设置和令人困惑的文档搏斗？是的，我也是。本课程让您在几分钟内从零到发布的NPM包，而不是几小时。

🎯 所得

这不仅仅是另一个代码仓库——它是一个 完整的学习系统:

• ✅ 工作计算器示例 (/mcp-calculator/)-复制、调整、发货
• ✅ 分步文档 (/docs/)无需猜测，只需跟随即可
• ✅ NPM发布工作流程 -从代码到Claude只需一个命令即可完成
• ✅ 漂亮的响应格式 -让你的工具看起来专业
• ✅ 本地测试设置 -部署前进行测试
• ✅ 故障排除指南 -当事情出错时（他们会）

🚀 开始使用

1.使用此模板：

# Use GitHub's template feature or download/copy the files
# Then navigate to your new project
cd your-mcp-project

2.查看工作示例：

# Look at the calculator example for reference
ls mcp-calculator/
# See the main server code
cat mcp-calculator/src/index.ts

3.这些文档是为Claude Code或其他编码代理提供的，可以帮助您：

• docs/mcp-basics.md -LLM的MCP概念
• docs/project-structure.md -LLM要复制的模板
• -LLM的发布工作流程
• 这些文档帮助编码代理指导您构建MCP服务器

💪 是什么让这与众不同

MCP新手？

• 没有BS -我解释一切，没有假设的知识
• 工作代码 -复制、调整、发货。完成。
• 真正的问题 -我已经打遍了每一堵墙，所以你不必这么做

已经知道你的东西了吗？

• 内置最佳实践 -TypeScript、验证、正确的错误处理
• 生产模式 -这从玩具项目扩展到真正的工具
• 跳过研究 -只需开始建设

📁 里面是什么

📦 mcp-course/
├── 🧮 mcp-calculator/          # Complete working example
│   ├── src/index.ts           # Main server code
│   ├── package.json           # NPM configuration
│   └── README.md              # Calculator-specific docs
├── 📚 docs/                   # Your learning materials
│   ├── mcp-basics.md          # MCP fundamentals
│   ├── project-structure.md   # Templates & patterns
│   ├── npm-setup.md           # Publishing workflow
│   ├── local-testing.md       # Testing strategies
│   └── troubleshooting.md     # Fix common issues
└── ⚡ RESPONSE_FORMATTING.md  # Make your tools look amazing

🗺️ 从哪里开始

从未构建过MCP服务器？ 从这里开始：

1. 阅读 docs/mcp-basics.md -了解MCP是什么
2. 探索 mcp-calculator/ -看一个真实的例子
3. 跟随 docs/project-structure.md -构建您的第一台服务器

准备好上线了吗？

1. docs/npm-setup.md -发布到NPM
2. docs/local-testing.md -彻底测试
3. docs/troubleshooting.md -当事情破裂时

🎯 你将真正学到什么

在经历了这些之后，你实际上会知道如何：

• ✅ 自信地用TypeScript构建MCP服务器
• ✅ 像专业人士一样处理用户输入验证
• ✅ 创建美观、专业的工具响应
• ✅ 发布到NPM并与Claude集成
• ✅ 不可避免地出现调试问题

🤝 贡献

发现损坏的东西或有更好的例子？发送PR。

📄 许可证

麻省理工学院-随意使用此代码。去创造一些很酷的东西。

______________________________________________________________________

*准备好构建您的第一台MCP服务器了吗？从 计算器示例 并遵循 文档!*