MCP 服务器

MCP Python SDK Documentation

好的，请提供您想让我翻译的 Read the Docs 文档内容，关于 MIT 去中心化 AI，MCP 黑客马拉松。我会尽力将其翻译成准确且自然的中文。

aidecentralized

开发者工具

访问服务器

README

MCP Python SDK 文档

本仓库包含模型上下文协议 (MCP) Python SDK 的文档。它使用 Sphinx 和 Read the Docs 主题构建。

概述

模型上下文协议 (MCP) 是一个开放标准，定义了应用程序如何与大型语言模型 (LLM) 交互。本文档旨在帮助开发者：

理解 MCP 的核心概念
构建 MCP 服务器以暴露资源、工具和提示
创建 MCP 客户端以连接到 MCP 服务器
探索高级主题和最佳实践

FastMCP

我们的文档全面涵盖了 FastMCP，这是一个用于构建 MCP 服务器的高级 Pythonic 接口。 FastMCP 最初是一个独立的项目，现已集成到官方 MCP Python SDK 中。它提供了一种开发者友好的方式来创建 MCP 服务器，只需最少的样板代码：

from mcp.server.fastmcp import FastMCP

mcp = FastMCP("Demo 🚀")

@mcp.tool()
def add(a: int, b: int) -> int:
    """Add two numbers"""
    return a + b

SDK 提供了多种运行服务器的方式：

使用 MCP Inspector 的开发模式
Claude Desktop 集成
直接执行以进行自定义部署

构建文档

安装依赖

首先，确保您已安装 Python。然后，安装所需的软件包：

# 使用 conda (推荐)
conda activate cuda_test
pip install -r requirements.txt

# 或者在虚拟环境中使用 pip
python -m venv venv
source venv/bin/activate  # 在 Windows 上: venv\Scripts\activate
pip install -r requirements.txt

构建文档

要构建文档：
```
make html
```
构建的文档将位于 _build/html/ 目录中。
实时预览

要进行具有自动重新加载的实时预览：
```
sphinx-autobuild . _build/html
```
然后打开浏览器访问 http://localhost:8000。

托管在 GitHub Pages 上

您可以按照以下步骤将此文档托管在 GitHub Pages 上：

创建 GitHub 仓库

# 如果您尚未初始化本地仓库，请初始化
git init
git add .
git commit -m "Initial commit with MCP documentation"

# 通过 Web 界面在 GitHub 上创建一个仓库
# 然后添加远程仓库并推送
git remote add origin https://github.com/yourusername/mcp_docs.git
git push -u origin main

设置 GitHub Pages

有两种方法可以为您的文档设置 GitHub Pages：

选项 1：使用 GitHub Actions（推荐）

该仓库已经包含一个 GitHub Actions 工作流程，位于 .github/workflows/docs.yml，它会在您每次推送到 main 分支时自动构建文档并将其部署到 GitHub Pages。
1. 转到您的 GitHub 仓库
2. 导航到 "Settings" > "Pages"
3. 在 "Source" 下，选择 "GitHub Actions"
4. 确保在您第一次推送后 "GitHub Actions" 工作流程正在运行
选项 2：使用 gh-pages 分支手动设置

如果您更喜欢手动管理部署：
```
# 创建一个孤立的 gh-pages 分支
git checkout --orphan gh-pages
git rm -rf .
touch .nojekyll
git add .nojekyll
git commit -m "Initial gh-pages commit"
git push origin gh-pages
git checkout main

# 构建文档并将其复制到 gh-pages
make html
git checkout gh-pages
cp -r _build/html/* .
git add .
git commit -m "Update documentation"
git push origin gh-pages
git checkout main
```
然后转到您的 GitHub 仓库的 Settings > Pages 并选择 gh-pages 分支作为源。
访问您的文档

您的文档将在以下位置可用： https://yourusername.github.io/mcp_docs/

更新文档

每当您想更新文档时：

# 如果使用 GitHub Actions
# 只需将您的更改推送到 main 分支
git add .
git commit -m "Update documentation"
git push origin main

# 如果使用手动 gh-pages 设置
make html
git checkout gh-pages
cp -r _build/html/* .
git add .
git commit -m "Update documentation"
git push origin gh-pages
git checkout main