← 返回目录

MCP for Beginners TypeScript Sample

社区

教程 / 资源合集

通过多语言实践学习 Model Context Protocol。

这是教程或资源合集，本身不能安装到客户端使用。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 文件系统第 21 / 24
Stars: ★ 17.5k 非常热门
运行环境: Node.js · Python · .NET · Java · Rust
凭据: 无需凭据
许可证: MIT
最近提交: 4 天前

43FMRS · D

资料显示这是 Microsoft 维护的 MCP 入门课程仓库中的 TypeScript 示例，而不是已公开工具清单和连接配置完整的独立 MCP 服务。

最强项 · 维护活跃度 12/20 最弱项 · 可靠性 5/20

可靠性

5/20

安全与权限

8/20

维护活跃度

12/20

文档质量

11/20

安装易用性

7/20

查看各项评分依据

可靠性 5/20: 提供的服务器路径只有 TypeScript 编译配置，未提供 server.ts、main.ts 的实现、工具定义、初始化握手、工具列表响应、错误处理或测试证据。因此无法验证服务器能否启动、完成 MCP 握手或使声明行为与实际行为一致；按静态审查保守扣分。
安全与权限 8/20: README 覆盖 MCP 安全、简单认证、RBAC、OAuth2 和 Entra ID 等主题，但这些是课程内容，不是该具体服务器实现的安全证据。未提供凭证处理、权限边界、数据流、外部网络访问、危险副作用或确认机制的代码，因此仅给予有限分数；未发现提示材料中的红线风险。
维护活跃度 12/20: 仓库未归档，声明有 MIT 许可证，并显示有 8 个开放 issue；这些信息表明项目具备基本维护和治理信号。未提供提交历史、发布记录、依赖更新、漏洞响应渠道或 issue 响应质量证据，因此未接近满分。
文档质量 11/20: README 对课程目标、模块、语言、示例、安全主题和学习路径进行了较全面说明，并提供仓库级克隆步骤。对于指定服务器，未提供可审查的安装依赖、启动命令、认证说明、工具参数、限制、成本、故障排查或行为示例，因此扣分。
安装易用性 7/20: README 只明确说明 fork、clone 和加入社区；未给出该 TypeScript 服务器的运行时版本、依赖安装、构建/启动命令、环境变量、主流 MCP 客户端配置或成功连接示例。安装路径因此无法被静态验证，易用性评分较低。

实测已过期收录于 2026-07-29

查看 FMRS 评分方法 →

选型与风险

能访问什么执行命令或代码

适合谁

具备至少一种支持语言基础的开发者
希望通过实践代码入门 MCP 的学习者
需要跨语言 MCP 学习资料的开发者

不适合谁

需要现成生产工具或业务集成的用户
需要已明确列出工具、传输方式或客户端配置的用户
不具备基本编程、客户端—服务器模型和 API 知识的用户

所需权限

源资料未说明该服务器需要的特定系统、网络、账户或数据权限
获取课程内容至少需要读取或克隆 GitHub 仓库的权限

风险与副作用

源资料未提供该示例服务器的具体工具、运行方式或权限边界
课程包含安全、认证和部署主题，但这些内容不代表该示例本身已实现相应安全能力
使用前应审查示例代码及其依赖，并避免将未审查的实现用于生产环境

安装接入

准备工作

运行环境：Node.js · Python · .NET · Java · Rust

按源资料中的步骤 Fork 仓库并克隆：git clone https://github.com/microsoft/mcp-for-beginners.git。源资料未提供该示例的运行命令或客户端配置。

验证是否装好

这是教程课程而非服务器；按 Module 3 的示例运行代码后，用 MCP Inspector（见 3.13 节）连接你构建的示例服务器，确认其工具出现在工具列表中即表示学习环境可用。

常见排障

确认仓库已成功克隆且示例路径为 03-GettingStarted/15-mcp-apps/code/typescript/my-app
确认 TypeScript 配置包含 server.ts 和 main.ts
如下载体积过大，可按 README 使用 sparse checkout 排除 translations 和 translated_images
源资料未提供运行或连接错误的具体排查步骤

试试这样问

连接成功后，可以直接对 AI 助手这样说：

如何用 TypeScript 构建我的第一个 MCP 服务器？
演示如何把课程中的 MCP 客户端接入 LLM。
Module 11 中如何部署集成 PostgreSQL 的 MCP 服务器？

使用场景

学习 MCP 基础概念

研究 TypeScript MCP Apps 示例

通过多种语言的代码示例学习 MCP 服务器和客户端开发

学习 MCP 安全、测试和部署相关主题

详细介绍

这是 microsoft/mcp-for-beginners 仓库中的 TypeScript MCP Apps 示例项目，位于 03-GettingStarted/15-mcp-apps/code/typescript/my-app。该仓库提供面向初学者的 MCP 课程、代码示例和实践指南，涵盖 C#、Java、JavaScript、Rust、Python 和 TypeScript，并介绍服务器、客户端、安全、测试、部署及服务编排等主题。