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 和本地腳本的結合，您可以輕鬆添加自定義服務器，豐富交互體驗。