Claude MCP 服务器集合

本仓库包含一系列模型上下文协议 (MCP) 服务器，通过将 Claude 连接到外部数据源和 API，扩展 Claude 的功能。这些服务器允许 Claude 访问实时信息，例如天气预报、电影数据和大学信息。

📋 内容

• 天气服务器: 使用国家气象局 API 获取实时天气预报和警报
• TMDB 电影服务器: 通过 The Movie Database API 访问有关电影和电视节目的信息
• Amity 大学爬虫: 从 Amity University Bengaluru 的网站提取和查询信息
• 文件系统服务器: 访问和管理本地文件系统上的文件

🛠️ 前提条件

在设置这些 MCP 服务器之前，请确保已安装以下其中一项：

• Docker（推荐，便于设置）
  • 适用于 Windows/Mac 的 Docker Desktop 或适用于 Linux 的 Docker Engine
  • 无需其他依赖项

或者，如果您希望在不使用 Docker 的情况下运行：

• Python 3.10+
• Git
• uv - 一个快速的 Python 包安装程序和解析器

UV 安装 --> https://docs.astral.sh/uv/getting-started/installation/

🚀 快速开始

选项 1：使用 Docker（推荐）

步骤 1：拉取 Docker 镜像

# 拉取天气 MCP 服务器
docker pull kunalondock/mcp-weather:pythonv1

# 拉取 TMDB 电影 MCP 服务器
docker pull kunalondock/mcp-movie:pythonv1

# 拉取 Amity 大学 MCP 服务器
docker pull kunalondock/mcp-amity:pythonv1

# 拉取文件系统 MCP 服务器
docker pull kunalondock/mcp-filesystem:pythonv1

步骤 2：配置 Claude Desktop

跳到下面的“连接到 Claude Desktop”部分，并使用 Docker 配置。

选项 2：使用 Python 手动设置

步骤 1：克隆仓库

# 克隆仓库
git clone https://github.com/kunalworldwide/mcp_server_demo.git

# 导航到项目目录
cd mcp_server_demo

步骤 2：安装 uv（如果尚未安装）

macOS/Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows:

curl -LsSf https://astral.sh/uv/install.py | python

安装完成后，重新启动终端以确保 uv 命令可用。

步骤 3：设置每个服务器

天气服务器

# 导航到 weather 目录
cd weather

# 创建一个虚拟环境并激活它
uv venv
source .venv/bin/activate  # 在 Windows 上：.venv\Scripts\activate

# 安装依赖项
uv pip install -r requirements.txt

# 测试服务器
uv run weather.py

TMDB 电影服务器

# 导航到 tmdb 目录
cd ../movieinfo/tmdb

# 创建一个虚拟环境并激活它
uv venv
source .venv/bin/activate  # 在 Windows 上：.venv\Scripts\activate

# 安装依赖项
uv pip install -r requirements.txt

# 打开 tmdb.py 并将 YOUR_API_KEY_HERE 替换为您的 TMDB API 密钥
# 您可以在 https://www.themoviedb.org/settings/api 获得免费的 API 密钥

# 测试服务器
uv run tmdb.py

Amity 大学爬虫

# 导航到 amity_crawler 目录
cd ../../amity_crawler/amitycrawler

# 创建一个虚拟环境并激活它
uv venv
source .venv/bin/activate  # 在 Windows 上：.venv\Scripts\activate

# 安装依赖项
uv pip install -r requirements.txt

# 测试服务器
uv run amity_crawler.py

🔌 连接到 Claude Desktop

要将这些服务器连接到 Claude Desktop，您需要配置 Claude Desktop 应用程序。

步骤 1：打开 Claude Desktop 配置文件

配置文件位于：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Roaming\Claude\claude_desktop_config.json

如果此文件不存在，请创建它。

步骤 2：添加服务器配置

选项 1：Docker 配置（推荐）

将以下内容添加到您的 claude_desktop_config.json 文件中以使用预构建的 Docker 镜像：

{
    "mcpServers": {
        "weather": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "kunalondock/mcp-weather:pythonv1"
            ]
        },
        "tmdb": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "-e", "TMDB_API_KEY=46c00bf3aa4f426c510c4b3a026c29d6",
                "--rm",
                "kunalondock/mcp-movie:pythonv1"
            ]
        },
        "amity": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "--mount", "type=volume,src=amity-data,dst=/app/amity_data",
                "kunalondock/mcp-amity:pythonv1"
            ]
        },
        "filesystem": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "--mount", "type=bind,src=C:\\path\\to\\your\\files,dst=/projects/files",
                "kunalondock/mcp-filesystem:pythonv1",
                "/projects"
            ]
        }
    }
}

注意：

• 对于文件系统服务器，将 C:\\path\\to\\your\\files 替换为要让 Claude 访问的 Windows 目录路径
• 在 macOS/Linux 上，使用适当的路径格式：/path/to/your/files
• TMDB API 密钥已预先配置，但您可以根据需要将其替换为您自己的密钥

选项 2：本地 Python 配置

如果您不使用 Docker 并且已使用 Python 在本地设置服务器，请改用此配置：

{
    "mcpServers": {
        "weather": {
            "command": "/path/to/your/uv",
            "args": [
                "--directory",
                "/absolute/path/to/mcp_server_demo/weather",
                "run",
                "weather.py"
            ]
        },
        "tmdb": {
            "command": "/path/to/your/uv",
            "args": [
                "--directory",
                "/absolute/path/to/mcp_server_demo/movieinfo/tmdb",
                "run",
                "tmdb.py"
            ]
        },
        "amity": {
            "command": "/path/to/your/uv",
            "args": [
                "--directory",
                "/absolute/path/to/mcp_server_demo/amitycrawler",
                "run",
                "amity_crawler.py"
            ]
        }
    }
}

将 /path/to/your/uv 替换为您的 uv 可执行文件的实际路径。您可以通过运行以下命令找到它：

which uv  # 在 macOS/Linux 上

(Get-Command uv).Source #在 Windows 上

另请将 /absolute/path/to/mcp_server_demo 替换为您克隆仓库的绝对路径。

步骤 3：重启 Claude Desktop

保存配置文件后，重启 Claude Desktop 以使更改生效。

🔍 测试服务器

连接后，您可以通过向 Claude 提出以下问题来测试每个服务器：

• 天气服务器:

  • "萨克拉门托的天气怎么样？"
  • "德克萨斯州是否有任何天气警报？"

• TMDB 电影服务器:

  • "目前有哪些电影很受欢迎？"
  • "帮我查找有关最近的科幻电影的信息。"
  • "现在有哪些电视节目正在流行？"

• Amity 大学服务器:

  • "Amity University Bengaluru 提供哪些课程？"
  • "计算机科学系的教职员工有哪些？"
  • "告诉我 Amity University 的招生流程。"

• 文件系统服务器:

  • "我的 Downloads 文件夹中有哪些文件？"
  • "读取 file.txt 的内容"
  • "创建一个名为 'claude-files' 的新目录"

🔧 故障排除

如果遇到问题，请尝试以下解决方案：

• Docker 未运行:

  • 确保 Docker Desktop 或 Docker Engine 正在运行
  • 检查您是否可以使用 docker run hello-world 运行一个简单的 Docker 容器

• 找不到 Docker 镜像:

  • 验证您是否使用 docker images | grep kunalondock 拉取了镜像
  • 如果未找到，请再次运行 docker pull 命令

• 服务器未在 Claude Desktop 中显示:

  • 检查您的 claude_desktop_config.json 是否存在语法错误
  • 确保您的配置中的路径正确
  • 完全重启 Claude Desktop

• 工具调用失败:

  • 检查 Claude 的日志中是否存在错误
  • 验证 Docker 是否可以访问必要的文件和目录
  • 确保您已配置正确的路径

• 检查 Claude 的日志:

  • macOS: 检查 ~/Library/Logs/Claude/ 中的日志文件
  • Windows: 检查 %APPDATA%\Claude\Logs\ 中的日志文件

🤝 贡献

欢迎增强这些服务器或添加新服务器。一些想法：

• 添加更详细的天气信息
• 扩展电影数据库以包括评论和推荐
• 添加更多大学信息来源

📄 许可证

本项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

🙏 致谢

• Anthropic 创建了 Claude 和模型上下文协议
• modelcontextprotocol.io 上的 MCP 文档
• 国家气象局和 TMDB 提供了他们的公共 API
• Amity University Bengaluru 提供了教育信息

---

祝您使用 AI 构建愉快！🚀