AI导哈

MCP教程服务器

一个教育性的MCP服务器，用于学习如何使用TypeScript和Node.js创建MCP服务器。

  • by jhosm
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 jhosm/MCP_Tutorial

使用说明

MCP教程服务器

一个教育型上下文协议 （MCP） 服务器，用于学习如何使用 TypeScript 和 Node.js 创建 MCP 服务器。

🎯 什么是MCP？

模型上下文协议（MCP）是一个开放的协议，允许人工智能应用程序（如Claude）以标准化的方式连接到外部工具和数据。

🚀 如何开始

先决条件

  • Node.js 16+
  • npm瓯纱

安装

npm install
npm run build

运行服务器

npm start

📚 项目结构

MCP_Tutorial/
├── src/
│   └── index.ts          # Código principal do servidor
├── build/                # Saída compilada (gerada após npm run build)
├── package.json          # Dependências e scripts
├── tsconfig.json        # Configuração TypeScript
└── README.md            # Este arquivo

🛠️ 已实现的工具

1. add_numbers

一个简单的工具，将两个数字相加。

参数 ：

  • a （number） 第一个数字
  • b （数字）：第二个数字

返回 ： 带有和结果的字符串

2. get_system_info

返回服务器所在系统的信息 。

参数 ： 无

返回 ： JSON 系统信息

3. process_text

通过应用不同的转换处理文本。

参数 ：

  • text （string）：文本到处理器
  • operation （enum） 操作之一：
    • uppercase转换为大写
    • lowercase：最小值转换器
    • reverse：逆变器o texto
    • word_count： 数字

返回 ： 操作结果

🔌 连接到VS代码

要将此服务器与 VS Code 配合使用：

  1. 创建文件 .vscode/mcp.json 在您的工作文件夹中：
{
  "mcpServers": {
    "tutorial": {
      "command": "node",
      "args": ["/absolute/path/to/MCP_Tutorial/build/index.js"]
    }
  }
}
  1. 重新启动VS代码，服务器将可用

📖 通过这个项目学习

这个项目展示了：

  • ✅ 如何在TypeScript中构建MCP项目
  • ✅ 如何注册工具（Tools）
  • ✅ 如何使用Zod验证输入
  • ✅ 如何返回正确格式化的答案
  • ✅ 如何使用STDIO传输
  • ✅ 如何编译TypeScript用于生产

🔗 有用的资源

📝 下一步

要扩展此服务器，您可以：

  1. 添加更多工具（Tools）
  2. 资源（Resources）
  3. 爱好者提示模板（提示）
  4. 实现 OAuth 身份验证
  5. 创建自动化测试

📄 许可证

麻省理工学院

👤 作者

若昂·米兰达-MCP教程

相关 MCP