使用说明
MCP部署
一个模型上下文协议(MCP)服务器,它公开了一个 sum_numbers 用于对整数列表求和的工具。此项目演示了使用FastMCP的简单MCP服务器实现。
项目概述
此MCP部署项目提供:
- sum_numbers工具:一个简单的工具,它接受一个整数列表并返回它们的和
- FastMCP服务器:基于MCP FastMCP框架构建,便于服务器实施
- Python 3.13+:使用具有类型提示和异步支持的现代Python
安装
先决条件
- Python 3.13或更高版本
uv包管理器(推荐)或pip
使用 uv (推荐)
-
安装
uv(如果尚未安装):# On Windows powershell -c "irm https://astral.sh/uv/install.ps1 | iex" # On macOS/Linux curl -LsSf https://astral.sh/uv/install.sh | sh -
克隆仓库:
git clone https://github.com/Mandapati-SuryanarayanaRaju/mcp-deployment.git cd mcp-deployment -
创建虚拟环境并安装依赖项:
uv sync -
运行MCP服务器:
uv run mcp-server
使用 pip
-
克隆仓库:
git clone https://github.com/Mandapati-SuryanarayanaRaju/mcp-deployment.git cd mcp-deployment -
创建虚拟环境:
python -m venv .venv source .venv/bin/activate # On Windows: .venv\Scripts\activate -
安装依赖项:
pip install -e . -
运行MCP服务器:
mcp-server
配置
Claude桌面配置
要将此MCP服务器与Claude Desktop一起使用,请将以下配置添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"Sum-numbers": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/Mandapati-SuryanarayanaRaju/mcp-deployment@main",
"mcp-server"
]
}
}
}
位置 claude_desktop_config.json:
- 视窗:
%APPDATA%\Claude\claude_desktop_config.json - macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
替代本地配置
如果您更喜欢在本地运行服务器,请使用:
{
"mcpServers": {
"sum-numbers": {
"command": "python",
"args": [
"-m",
"mcpserver"
],
"cwd": "/path/to/mcp-deployment"
}
}
}
可用工具
sum_numbers
对整数列表求和。
参数:
numbers(list[int]):要求和的整数列表
退货:
- (int):列表中所有整数的和
示例:
result = sum_numbers([1, 2, 3, 4, 5])
# Returns: 15
项目结构
mcp-deployment/
src/
mcpserver/
__init__.py
__main__.py
deployment.py
pyproject.toml
README.md
uv.lock
依赖项
mcp[cli]>=1.23.1:支持CLI的模型上下文协议库- Python 3.13+
发展
要贡献或修改服务器,请执行以下操作:
-
在开发模式下安装:
uv sync -
编辑
src/mcpserver/deployment.py添加新工具或修改现有工具 -
本地测试:
uv run mcp-server
许可证
这个项目是开源的。有关详细信息,请参阅LICENSE文件。
支持
对于问题或疑问,请在GitHub上打开问题: mcp部署问题