使用说明
首次使用uv包安装依赖项
uv add requirements.txt
您可以使用
python -m pip install requirements.txt
MCP项目基本设置
此存储库包含项目的基本设置步骤,使用 uv 用于依赖关系管理和环境设置,以及配置在MCP(多工具控制面板)环境中使用的工具,可能类似于Claude Desktop。
先决条件
- Python 3.7+(推荐)
- 网络访问下载
uv以及项目依赖关系。
安装
本节将指导您完成设置 uv 工具并初始化项目环境。
1.安装 uv
uv 用于高效管理Python环境和依赖关系。选择与您的操作系统相对应的命令。
Windows(PowerShell):
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
macOS/Linux(Bash):
curl -LsSf https://astral.sh/uv/install.sh | sh
运行安装命令后 关键的 重新启动终端或命令提示符以确保 uv 命令在PATH中被识别。
2.项目设置
现在,让我们创建项目目录,设置虚拟环境,安装必要的依赖项,并创建主服务器文件。
macOS/Linux:
# Create a new directory for our project (e.g., 'weather')
uv init weather
# Navigate into the project directory
cd weather
# Create a virtual environment inside the project folder
uv venv
# Activate the virtual environment
source .venv/bin/activate
# Install project dependencies.
# mcp[cli] requires extra dependencies for the command-line interface.
uv add "mcp[cli]" httpx
# Create our server file (where your application code will reside)
touch weather.py
Windows(命令提示符或PowerShell):
# Create a new directory for our project (e.g., 'weather')
uv init weather
# Navigate into the project directory
cd weather
# Create a virtual environment inside the project folder
uv venv
# Activate the virtual environment
.venv\Scripts\activate
# Install project dependencies.
# mcp[cli] requires extra dependencies for the command-line interface.
uv add mcp[cli] httpx
# Create our server file (where your application code will reside)
new-item weather.py
此时,您有一个项目目录(j),一个专用的虚拟环境(.venv),已安装库(mcp[cli], httpx),以及一个空文件(“”),您可以在其中添加应用程序逻辑。
配置(适用于克劳德桌面MCP)
如果您将此项目与Claude Desktop或类似的MCP工具一起使用,则需要对其进行配置以识别和运行您的工具。下面是一个配置结构的示例,它定义了如何启动不同的工具。
注: MCP配置文件的确切位置和格式取决于您使用的特定MCP软件(例如,Claude Desktop的设置)。以下是潜在配置部分的内容:
{
"mcpServers": {
"product_data_tools": {
"command": "uv",
"args": [
"--directory",
"C:\\Users\\asus4\\OneDrive\\Bureau\\mcp-Project\\project\\mcp-project",
"run",
"server.py"
]
},
"Bright Data": {
"command": "npx",
"args": ["@brightdata/mcp"],
"env": {
"API_TOKEN": "api_token",
"WEB_UNLOCKER_ZONE": "unlocker_zone",
"BROWSER_ZONE":"your BROWSER_ZONE"
}
},
"actors-mcp-server": {
"command": "npx",
"args": [
"-y",
"@apify/actors-mcp-server",
"--actors",
"autofacts/shopify"
],
"env": {
"APIFY_TOKEN": "api_token"
}
}
}
}
product_data_tools:此条目定义了一个运行Python服务器文件的工具(server.py,尽管在我们的设置中我们创建了weather.py-你需要调整args如果你坚持weather.py).使用uv run在由管理的虚拟环境中执行该文件uv. 记得更新--directory路径 到项目目录的实际位置(weather)在您的系统上。Bright Data:配置一个使用以下命令运行Bright Data MCP服务器的工具npx。需要特定的环境变量进行身份验证和区域选择。actors-mcp-server:配置一个使用以下命令运行Apify Actors MCP服务器的工具npx。需要API令牌。
在MCP软件中添加或更新配置文件后, 保存文件,然后重新启动Claude for Desktop (或您的特定MCP工具)使更改生效。
用法
设置环境、应用MCP配置并重新启动MCP工具后,您应该能够与配置的工具进行交互(product_data_tools, Bright Data, actors-mcp-server)直接通过MCP软件的界面(例如Claude Desktop)。
你“使用”每个工具的具体方式取决于它的实现。对于 product_data_tools,通常会与API或由 server.py 您创建的文件。
视觉效果/示例(占位符)
演示如何在Claude Desktop(或您选择的MCP软件)界面中触发或与配置的工具交互的图像或屏幕截图在这里会有所帮助。
[在此处插入相关图像的URL,如果没有提供图像,请删除此部分]
运行服务器
uv run server.py
uv run mcp_data_server.py
此README提供了一个清晰的、循序渐进的指南,用于根据您的输入设置项目并配置它以与MCP工具一起使用。请记住填写任何占位符,如特定路径或API令牌。
