MCP conda Claude tutorial

直接复制此存储库以测试Cursor/Claude提交技能。

使用conda和Claude的MCP基础知识

Daina在其中快速开发了PyData VT教程（幻灯片 这里).

一个模型上下文协议（MCP）服务器，将Claude Desktop连接到《纽约时报》图书API，使Claude能够搜索和检索有关纽约时报畅销书列表的信息。

本教程演示了如何使用Python和conda构建MCP服务器，提供了使用外部数据源扩展Claude功能的实用介绍。

关于本教程

本教程旨在演示：

• 用Python构建MCP服务器
• 使用conda进行环境管理
• 将外部API与Claude Desktop集成

非常适合希望使用自定义数据源和工具扩展Claude功能的开发人员！

什么是MCP？

模型上下文协议（MCP）是一个开放标准，允许像Claude这样的人工智能助手连接到外部数据源和工具。将其视为一座桥梁，让Claude访问其训练数据之外的信息。在这种情况下，来自《纽约时报》图书API的实时数据。

当你问Claude关于《纽约时报》畅销书的问题时，Claude意识到它需要外部数据，调用这个MCP服务器，然后查询《纽约时报API》并返回结果。

特性

此MCP服务器提供了Claude可以使用的两个工具：

• get_best_seller：从特定的《纽约时报》畅销书列表中检索书籍（小说、非小说等）
• get_best_sellers_概述：获取所有畅销书排行榜的概述，包括每本书的前5本书

先决条件

• 克劳德桌面 安装
• A. 《纽约时报》开发者API密钥 （免费）

项目结构

nytimes-mcp-server/
├── nytimes_mcp_server/        # Main package directory
│   ├── __init__.py            # Package initialization
│   ├── __main__.py            # Entry point for running as module
│   ├── server.py              # MCP server implementation
│   └── nyt_api.py             # NYTimes API wrapper
├── .env                       # Your API key (never commit this!)
├── .env.example               # An example environment file just for this tutorial
├── .gitignore                 # Git ignore rules 
├── test_manual.py             # Test script for API connectivity
└── README.md                  # This file

安装

步骤1：获取您的《纽约时报》API密钥

1. 首选https://developer.nytimes.com/get-started
2. 注册或登录
3. 在中创建新应用程序 您的应用程序
4. 启用“书籍API”
5. 复制API密钥

步骤2：克隆此存储库

git clone https://github.com/yourusername/nytimes-mcp-server.git
cd nytimes-mcp-server

步骤3：创建Conda环境

# Create the environment with required dependencies
conda create -n mcp_tutorial python=3.13 -y

# Activate the environment
conda activate mcp_tutorial

# Install dependencies
conda install mcp httpx python-dotenv -y

步骤4：配置您的API密钥

创建 .env 项目根目录中的文件。您可以复制.env.example文件并编辑内容，也可以创建自己的文件：

cp .env.example .env

编辑 .env 并添加您的API密钥：

NYTIMES_API_KEY=your_actual_api_key_here

重要提示： 永远不要承诺你的 .env 文件到版本控制！添加 .env 给你的 .gitignore 文件。

步骤5：测试您的设置

运行测试脚本以验证一切正常：

python test_manual.py

您应该看到显示API成功调用NYTimes Books API的输出。

连接到克劳德桌面

第一步：找到你的路

获取项目的绝对路径：

pwd

获取您的conda Python路径（环境已激活）：

which python

步骤2：配置Claude桌面

编辑Claude Desktop配置文件。\ 您可以通过导航到 设置>开发人员>编辑配置 或者运行以下命令：

macOS： （TextEdit或您最喜欢的文本编辑器）

open -a TextEdit ~/Library/Application\ Support/Claude/claude_desktop_config.json

窗户：

%APPDATA%\Claude\claude_desktop_config.json

Linux：

~/.config/Claude/claude_desktop_config.json

添加您的服务器配置（用上述步骤中的实际路径替换路径）：

{
  "mcpServers": {
    "nytimes-books": {
      "command": "/path/to/anaconda3/envs/mcp_tutorial/bin/python",
      "args": [
        "-m",
        "nytimes_mcp_server"
      ],
      "cwd": "/path/to/nytimes-mcp-server",
      "env": {
        "PYTHONPATH": "/path/to/nytimes-mcp-server"
      }
    }
  }
}

配置说明：

• command：conda环境Python解释器的完整路径

- 必须是Python解释器的绝对路径 - 指向特定conda环境中的Python

*了解路径：*

/opt/anaconda3/envs/mcp_tutorial/bin/python
│    │         │    │            │   └─ Python executable
│    │         │    │            └───── bin directory (executables)
│    │         │    └────────────────── Your environment name
│    │         └─────────────────────── conda environments directory
│    └───────────────────────────────── Anaconda installation
└────────────────────────────────────── Root directory

• args: -m 告诉Python将包作为模块运行 nytimes_mcp_server 是我们包裹的名字吗
• cwd：当前工作目录（其中 .env 位于）

- 必须是通往代码所在位置的绝对路径 - 这是服务器运行的地方

• env.PYTHONPATH：告诉Python在哪里找到您的包

步骤3：重新启动克劳德桌面

1. 完全退出Claude Desktop（不仅仅是关闭窗口）
2. 重新打开克劳德桌面
3. 引导到 设置>开发人员 查看您的本地MCP服务器是否成功运行

第四步：试试看！

创建新聊天，然后单击搜索和工具图标。确保 nytimes-books 打开工具，然后问克劳德以下问题：

• “本月最畅销的小说是什么？”
• “向我展示《纽约时报》所有畅销书排行榜的概览”
• “目前精装非小说类书籍排行榜上排名第一的是什么？”

Claude现在应该使用您的MCP服务器来获取实时数据！

故障排除

服务器无法启动

检查日志：

# macOS
tail -f ~/Library/Logs/Claude/mcp*.log

# Windows
# Check %APPDATA%\Claude\logs\

# Linux
# Check ~/.config/Claude/logs/

常见问题：

1. “没有名为nytimes_mcp_server的模块”

- 确保 PYTHONPATH 已在配置中设置 - 验证 cwd 和 PYTHONPATH 两者都指向您的项目根

1. “找不到API密钥”

- 检查 .env 存在于由指定的目录中 cwd - 验证API密钥是否在中正确设置 .env

1. API返回404个错误

- 在验证您的API密钥是否有效https://developer.nytimes.com/ - 确保已为密钥启用Books API

手动测试

您可以直接测试服务器：

cd /path/to/nytimes-mcp-server
conda activate mcp_tutorial
python -m nytimes_mcp_server

服务器应启动并显示：

INFO:root:Starting NYTimes Books MCP Server
INFO:root:API key found, starting server...

按Ctrl+C停止它。

运作原理

建筑

You ask Claude a question
         ↓
Claude Desktop recognizes it needs NYTimes data
         ↓
Claude calls your MCP server (via stdio)
         ↓
Your MCP server queries the NYTimes API
         ↓
Results flow back to Claude
         ↓
Claude presents the answer to you

关键组件

1. 现在_api.py：处理与《纽约时报》图书API的所有交互

- 管理HTTP请求 - 格式化API响应 - 优雅地处理错误

1. 服务器.py：实现MCP服务器

- 定义Claude可以使用的工具 - 处理工具执行请求 - 管理与Claude Desktop的通信

1. __主要的__南美国家巴拉圭的缩写（Paraguay）：运行服务器的入口点

- 设置异步事件循环 - 初始化stdio通信

发展

运行测试

python test_manual.py

项目依赖项

• 主控程序：Anthropic官方MCP SDK
• httpx：用于API调用的现代HTTP客户端
• python dotenv：从.env文件加载环境变量

接下来是什么？

本教程涵盖了构建MCP服务器的基础知识，但还可以添加更多内容。潜在的增强功能包括：

1. 缓存：暂时存储API结果以减少API调用
2. 更多端点：《纽约时报》图书API有额外的终点（如评论和历史）
3. 高级搜索：实现过滤和排序选项
4. 错误恢复：为瞬态故障添加重试逻辑
5. 速率限制：执行请求节流以遵守API限制

一个单独的教程正在为MCP+conda+Claude Code编写中。

了解有关MCP的更多信息

• MCP文件
• Anthropic的MCP指南

贡献

欢迎投稿！请随时提交拉取请求。

致谢

• 与 模型上下文协议
• 使用 《纽约时报》图书API
• 为Anaconda社区开发的教程