Skip to main content

概述

本指南将带您快速构建一个简单的 MCP 服务器,让您了解 Model Context Protocol 的基本工作原理。
前提条件:
  • Python 3.8+ 或 Node.js 18+
  • 对 JSON-RPC 有基本了解(可选)

选择开发语言

MCP 支持多种编程语言。选择您熟悉的语言开始:

Python

使用官方 Python SDK 快速开始

TypeScript

使用官方 TypeScript SDK 开发

Python 实现

第 1 步:安装 SDK

第 2 步:创建基本服务器

创建一个名为 mcp_server.py 的文件:

第 3 步:运行服务器

TypeScript 实现

第 1 步:安装 SDK

第 2 步:创建基本服务器

创建一个名为 server.ts 的文件:

第 3 步:运行服务器

测试您的服务器

使用 Claude Desktop 测试

  1. 打开 Claude Desktop 应用
  2. 在设置中配置您的 MCP 服务器:
  1. 重启 Claude Desktop
  2. 在对话中尝试:
    • @greeting/Alice - 获取问候资源
    • 要求计算 2 + 2 - 使用计算工具

使用命令行测试

您也可以使用 MCP Inspector 工具:

下一步

恭喜!您已经创建了第一个 MCP 服务器。接下来可以:

深入了解核心概念

学习 MCP 的资源、工具和提示概念

探索更多示例

查看实际的应用案例和代码示例

阅读实现指南

了解如何构建生产级的 MCP 服务器

安全最佳实践

学习如何安全地部署 MCP 服务

故障排除

检查:
  • Python/Node.js 版本是否符合要求
  • 依赖是否正确安装
  • 端口是否被占用
确保:
  • 配置文件格式正确
  • 文件路径正确
  • 重启了 Claude Desktop
验证:
  • 工具参数定义正确
  • 函数实现没有错误
  • 返回值格式符合规范