Claude MCP Servers Collection

Claude MCP 服务集合

此仓库包含一组 Model Context Protocol（MCP）服务，通过将 Claude 连接到外部数据源和 API 来扩展其能力。这些服务可让 Claude 访问天气预报、电影数据和大学信息等实时信息。

📋 内容

• Weather Server：使用 National Weather Service API 获取实时天气预报和预警
• TMDB Movie Server：通过 The Movie Database API 获取电影和电视节目相关信息
• Amity University Crawler：从 Amity University Bengaluru 网站提取和查询信息
• Filesystem Server：访问和管理本地文件系统中的文件

🛠️ 先决条件

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

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

或者，如果你更愿意在不使用 Docker 的情况下运行：

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

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

🚀 开始使用

选项 1：使用 Docker（推荐）

第 1 步：拉取 Docker 镜像

# Pull the Weather MCP server
docker pull kunalondock/mcp-weather:pythonv1

# Pull the TMDB Movie MCP server
docker pull kunalondock/mcp-movie:pythonv1

# Pull the Amity University MCP server
docker pull kunalondock/mcp-amity:pythonv1

# Pull the Filesystem MCP server
docker pull kunalondock/mcp-filesystem:pythonv1

第 2 步：配置 Claude Desktop

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

选项 2：使用 Python 手动设置

第 1 步：克隆仓库

# Clone the repository
git clone https://github.com/kunalworldwide/mcp_server_demo.git

# Navigate to the project directory
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 Server

# Navigate to the weather directory
cd weather

# Create a virtual environment and activate it
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
uv pip install -r requirements.txt

# Test the server
uv run weather.py

TMDB Movie Server

# Navigate to the tmdb directory
cd ../movieinfo/tmdb

# Create a virtual environment and activate it
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
uv pip install -r requirements.txt

# Open tmdb.py and replace YOUR_API_KEY_HERE with your TMDB API key
# You can get a free API key at https://www.themoviedb.org/settings/api

# Test the server
uv run tmdb.py

Amity University Crawler

# Navigate to the amity_crawler directory
cd ../../amity_crawler/amitycrawler

# Create a virtual environment and activate it
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
uv pip install -r requirements.txt

# Test the server
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  # On macOS/Linux

(Get-Command uv).Source #On Windows

此外，将 /absolute/path/to/mcp_server_demo 替换为你克隆仓库所在位置的绝对路径。

第 3 步：重启 Claude Desktop

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

🔍 测试服务

连接后，你可以向 Claude 提出以下问题来测试各个服务：

• Weather Server：

  • “萨克拉门托的天气怎么样？”
  • “得克萨斯州有天气预警吗？”

• TMDB Movie Server：

  • “目前有哪些热门电影？”
  • “帮我查找近期科幻电影的信息。”
  • “现在有哪些热门电视剧？”

• Amity University Server：

  • “Amity University Bengaluru 开设了哪些课程？”
  • “计算机科学系有哪些教职员工？”
  • “介绍一下 Amity University 的招生流程。”

• Filesystem Server：

  • “我的 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 许可，详情请参阅 LICENSE 文件。

🙏 致谢

• 感谢 Anthropic 创建 Claude 和 Model Context Protocol
• MCP 文档：modelcontextprotocol.io
• 感谢 National Weather Service 和 TMDB 提供公共 API
• 感谢 Amity University Bengaluru 提供教育信息

---

祝你用 AI 开发愉快！🚀