使用说明

Claude MCP服务器集合

此存储库包含一组模型上下文协议（MCP）服务器，通过将Claude连接到外部数据源和API来扩展其功能。这些服务器允许克劳德访问实时信息，如天气预报、电影数据和大学信息。

📋 目录

天气服务器：使用美国国家气象局API获取实时天气预报和警报
TMDB电影服务器：通过电影数据库API访问有关电影和电视节目的信息
阿米蒂大学爬虫：从班加罗尔阿米蒂大学网站提取和查询信息
文件系统服务器：访问和管理本地文件系统上的文件

🛠️ 先决条件

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

码头工人 （建议易于设置）
- Windows/Mac版Docker桌面或Linux版Docker引擎
- 不需要其他依赖项

或者，如果你更喜欢在没有Docker的情况下运行：

Python 3.10+
Git
紫外线 -一个快速的Python包安装程序和解析器

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

🚀 入门指南

选项1：使用Docker（推荐）

第一步：拉取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桌面

跳到下面的“连接到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

视窗:

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

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

步骤3：设置每个服务器

天气服务器

# 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电影服务器

# 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

阿米蒂大学爬虫

# 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应用程序。

步骤1：打开Claude桌面配置文件

配置文件位于：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
视窗: %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提出以下问题来测试每台服务器：

天气服务器:
- “萨克拉门托的天气怎么样？”
- “得克萨斯州有天气警报吗？”
TMDB电影服务器:
- “现在流行什么电影？”
- “为我查找有关最近科幻电影的信息。”
- “现在流行什么电视节目？”
阿米蒂大学服务器:
- 班加罗尔阿米蒂大学提供哪些课程
- “计算机科学系的教员是谁？”
- “告诉我阿米蒂大学的录取程序。”
文件系统服务器:
- “我的下载文件夹中有哪些文件？”
- “读取.txt文件的内容”
- “创建一个名为“claude files”的新目录”

🔧 故障排除

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

Docker未运行:
- 确保Docker桌面或Docker引擎正在运行
- 检查你是否可以运行一个简单的Docker容器 docker run hello-world
找不到Docker映像:
- 验证您是否使用以下命令拉取了图像 docker images | grep kunalondock
- 如果未找到，请再次运行docker pull命令
服务器未显示在Claude Desktop中:
- 检查你的 claude_desktop_config.json 语法错误
- 确保配置中的路径正确
- 完全重新启动克劳德桌面
工具调用失败:
- 检查克劳德的日志是否有错误
- 验证Docker是否可以访问必要的文件和目录
- 确保您配置了正确的路径
检查克劳德的日志:
- macOS：检查日志文件 ~/Library/Logs/Claude/
- Windows：检查中的日志文件 %APPDATA%\Claude\Logs\

🤝 贡献

您可以随意增强这些服务器或添加新的服务器。一些想法：

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

📄 许可证

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

🙏 致谢

创建克劳德的拟人化和模型上下文协议
MCP文件位于模型上下文协议.io
国家气象局和TMDB的公共API
班加罗尔阿米蒂大学教育信息

用AI构建快乐！ 🚀