MCP Server 101

本指南详细介绍了如何设置一个与Claude Desktop集成的模型控制协议(MCP)服务器，该服务器通过Python脚本扩展Claude的功能，使其能够与AWS服务和GitHub等外部系统交互。文档包含安装步骤、配置方法、高级功能及故障排除等内容。

开发者工具云平台 #模型控制 #服务集成 #Python扩展 .Python

评分 : 2分

下载量 : 18

更新时间 : 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