MCP Server 101

本指南詳細介紹瞭如何設置一個與Claude Desktop集成的模型控制協議(MCP)服務器，該服務器通過Python腳本擴展Claude的功能，使其能夠與AWS服務和GitHub等外部系統交互。文檔包含安裝步驟、配置方法、高級功能及故障排除等內容。

開發者工具雲平臺 #模型控制 #服務集成 #Python擴展 .Python

評分 : 2分

下載量 : 7.1K

更新時間 : 2025-04-28

打開站點

什麼是MCP服務器？

MCP（Model Control Protocol）服務器是一種工具，用於連接Claude Desktop與外部系統和服務，例如AWS和GitHub。它允許您創建自定義函數來執行特定任務，從而增強Claude的功能。

如何使用MCP服務器？

要開始使用MCP服務器，請按照以下步驟安裝、配置並啟動它。確保您的環境已準備好運行Python 3.8及以上版本，並且Claude Desktop已安裝。

適用場景

MCP服務器非常適合需要自動化任務的企業用戶，如雲資源管理、數據分析和代碼協作等。

主要功能

與AWS服務集成

通過MCP服務器，您可以輕鬆地管理和監控AWS資源，如EC2實例、S3存儲桶等。

與GitHub集成

MCP服務器支持與GitHub API交互，方便您獲取倉庫信息或自動化代碼審查流程。

自定義函數開發

您可以編寫自己的Python函數並與Claude Desktop共享，實現個性化的業務邏輯。

優勢

簡化複雜的API調用過程

提高工作效率

支持多種編程語言

易於部署和維護

侷限性

需要一定的編程基礎

依賴於網絡連接

可能涉及較高的安全風險

如何使用

安裝必要軟件

確保您的計算機上安裝了Python 3.8及以上版本以及uv包管理器。

創建服務器腳本

在您的工作目錄下創建一個名為server.py的新文件，並添加所需的函數。

測試服務器

在終端中運行以下命令以驗證服務器是否正常工作。

配置Claude Desktop

打開Claude Desktop應用程序，導航至設置頁面並輸入服務器配置信息。

使用案例

查詢AWS EC2實例

演示如何使用MCP服務器查詢AWS上的EC2實例。

獲取GitHub倉庫信息

展示如何利用MCP服務器訪問GitHub API來獲取倉庫詳情。

常見問題

如何解決連接失敗的問題？

為什麼我的自定義函數不起作用？

🚀 MCP 服務器設置文檔

本指南詳細介紹瞭如何設置與 Claude Desktop 集成的 Model Control Protocol (MCP) 服務器。MCP 服務器可讓 Claude 與外部系統和 API（如 AWS 服務和 GitHub）交互，從而擴展其功能。

🚀 快速開始

本指南將引導你完成與 Claude Desktop 集成的 MCP 服務器的設置過程。

✨ 主要特性

允許 Claude 與外部系統和 API 交互，擴展其能力。
支持多種平臺，包括 Linux、OSX 和 Windows。
可通過配置文件和環境變量進行靈活配置。

📦 安裝指南

先決條件

安裝 Python 3.8+
安裝 Claude Desktop 應用程序
安裝 uv 包管理器
具備 Python 和命令行操作的基礎知識

安裝步驟

1. 安裝所需包

使用 uv 運行以下命令安裝所需的包：

uv add MCP --platforms linux/x86_64,linux/arm64,osx/x86_64,osx/arm64,win/x86_64,win/arm64

2. 創建 MCP 配置文件

創建 ~/.config/mcp/config.json 文件，並添加以下內容：

{
    "version": "1.0",
    "servers": {
        "local": {
            "host": "localhost",
            "port": 5005,
            "type": "grpc"
        }
    },
    "apis": {
        "aws": {
            "region": "us-east-2",
            "access_key_id": "YOUR_ACCESS_KEY_ID",
            "secret_access_key": "YOUR_SECRET_ACCESS_KEY"
        },
        "github": {
            "token": "YOUR_GITHUB_TOKEN"
        }
    }
}

3. 啟動 MCP 服務器

在終端中運行以下命令啟動 MCP 服務器：

uv run MCP --server local

💻 使用示例

基礎用法

測試服務器

驗證 MCP 服務器是否正常運行：

curl http://localhost:5005/ping

預期輸出：

{
    "status": "success",
    "message": "MCP server is running"
}

高級用法

配置 Claude Desktop

1. 打開設置

在 Claude Desktop 中，導航至 Edit > Settings。

2. 添加 MCP 服務器

在 Services 標籤下，點擊 Add Service 並輸入以下信息：

Name: MCP Server
Type: Custom
URL: http://localhost:5005

3. 應用設置

點擊 Add 完成配置。

高級配置

環境變量

在終端中運行以下命令以設置環境變量：

export MCP_API_KEY="your_api_key"

自定義依賴項

編輯 ~/.config/mcp/config.json 文件並添加自定義依賴項：

{
    "dependencies": {
        "custom-package": "^1.0.0"
    }
}

運行以下命令安裝依賴項：

uv run MCP --install

錯誤處理

在 ~/.config/mcp/errors.log 文件中查看錯誤日誌。

📚 詳細文檔

故障排除

問題：無法連接到服務器

解決方案：檢查服務器狀態：

curl http://localhost:5005/ping

確保防火牆允許端口 5005 的流量。

問題：配置文件無效

解決方案：驗證 config.json 文件格式是否正確，必要時使用 JSON 校驗工具進行檢查。

使用案例

AWS 集成

import boto3

def list_ec2_instances():
    ec2 = boto3.client('ec2', region_name='us-east-2')
    instances = ec2.describe_instances()
    return instances['Reservations']

GitHub 集成

import os
from github import Github

def get_repository_info(repo):
    g = Github(os.getenv("GITHUB_TOKEN"))
    repo = g.get_repo(repo)
    return repo.raw_data