Claude MCP Servers Collection

🚀 克拉拉 MCP 项目文档

本项目为 Claude 的 Model Context Protocol (MCP) 示例项目提供支持，展示了如何借助 Docker 和本地 Python 脚本扩展 Claude 的功能。项目提供了天气、TMDB 电影、Amity 大学信息以及文件系统访问四个服务器，助力用户丰富与 Claude 的交互体验。

🚀 快速开始

使用 Docker 配置服务器

编辑 claude_desktop_config.json 文件，添加如下配置：

{
  "mcpServers": {
    "weather": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "kunal/mcp-weather:latest"
      ]
    },
    "tmdb": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "kunal/mcp-tmdb:latest"
      ]
    },
    "amity-university": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "kunal/mcp-amity:latest"
      ]
    },
    "file-system": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "--mount",
        "type=bind,src=/path/to/files,dst=/projects/files",
        "kunal/mcp-file-system:latest",
        "/projects"
      ]
    }
  }
}

使用本地 Python 脚本配置服务器

编辑 claude_desktop_config.json 文件，添加以下配置：

{
  "mcpServers": {
    "weather": {
      "command": "$(which uv)",
      "args": [
        "--directory",
        "/path/to/mcp-weather",
        "run",
        "weather.py"
      ]
    },
    "tmdb": {
      "command": "$(which uv)",
      "args": [
        "--directory",
        "/path/to/mcp-tmdb",
        "run",
        "tmdb.py"
      ]
    },
    "amity-university": {
      "command": "$(which uv)",
      "args": [
        "--directory",
        "/path/to/mcp-amity",
        "run",
        "amity_crawler.py"
      ]
    }
  }
}

✨ 主要特性

本项目通过 Docker 和本地 Python 脚本扩展了 Claude 的功能，提供了四个实用的服务器：

• 天气服务器：可查询各地天气情况。
• TMDB 电影服务器：能获取正在热映的电影信息。
• Amity 大学服务器：提供 Amity 大学各校区的课程信息。
• 文件系统服务器：支持对文件系统进行访问和操作。

📦 安装指南

1. Docker

• 安装指南：可参考 Docker 官方文档。
• 验证安装：使用以下命令验证 Docker 是否安装成功：

docker --version

2. UV 指令工具

• 获取 UV：使用 Docker 镜像获取 UV，命令如下：

docker pull ghcr.io/anthropic/uv-cli:latest

• 检查路径：安装完成后，使用以下命令检查 UV 的路径：

which uv # macOS/Linux
(Get-Command uv).Source # Windows

💻 使用示例

基础用法

测试服务器

• 天气服务器：查询示例："Sacramento 当前天气如何？"
• TMDB 电影服务器：查询示例："哪些电影正在热映？"
• Amity 大学服务器：查询示例："Bengaluru 校区提供哪些课程？"
• 文件系统服务器：查询示例："下载文件夹中有哪些文件？"

🔧 故障排除

常见问题

1. Docker 不运行
   • 确保 Docker Desktop 或 Docker 引擎已启动。
   • 使用 docker run hello-world 测试容器运行。
2. 镜像未找到
   • 检查镜像是否存在：docker images | grep kunal/mcp-。
   • 如有必要，重新拉取镜像。

📄 项目贡献者

• Kunal Chhabra（@kunalc）

此文档为扩展 Claude 功能提供了详细指南。通过 Docker 和本地脚本的结合，您可以轻松添加自定义服务器，丰富交互体验。