______________________________________________________________________
MCP文件服务——克劳德集成
此项目演示了如何连接 拟人克劳德桌面 按照习俗 MCP（模型上下文协议） 在基于CSV的库存系统上执行CRUD操作的工具。 MCP层允许Claude通过自然语言与您的本地库存进行交互——读取、添加、更新和删除结构化CSV文件中的行。
______________________________________________________________________
📦 特性
- 通过MCP协议公开CRUD操作
- 使用简单的CSV文件进行持久存储
- 通过以下方式直接与Claude Desktop集成
stdio运输 - 已实施
fastmcp用于快速设置和异步支持
______________________________________________________________________
⚙️ 安装说明
1.克隆存储库
git clone https://github.com/Pavi-NP/test-mcp-Claude.git
2.创建并激活虚拟环境（推荐）
/opt/homebrew/bin/python3 -m venv venv
source venv/bin/activate
pip install --upgrade pip
pip install mcp fastmcp您可以验证安装：
pip list | grep mcp______________________________________________________________________
🧠 克劳德配置
允许 克劳德桌面 要连接到MCP服务，请更新配置文件以包含MCP服务器命令：
{
"mcpServers": {
"file-service": {
"command": "Your file path",
"args": [
"Your file path"
]
}
}
}编辑配置后：
- 彻底退出克劳德(
Cmd+Q在macOS上）。 - 等几秒钟。
- 重新打开克劳德桌面。
- 确认连接器上的连接（适用于MCP工具）。
______________________________________________________________________
🚀 手动运行MCP服务器
要在Claude之外测试服务，只需运行：
python mcp_file_service.py按 Ctrl+C 停止服务器。
______________________________________________________________________
🧩 可用工具
| 工具名称 | 描述 |
|---|---|
read_csv() | 从库存文件中读取所有记录 |
add_row(name, qty) | 添加具有唯一ID的新产品 |
update_qty(row_id, qty) | 按ID更新项目的数量 |
delete_row(row_id) | 按ID删除产品 |
update_qty_by_name(name, additional_qty) | 按产品名称添加数量 |
CSV格式示例(demo.csv):
id,name,qty
921ub7,USB,37
531wm2, wireless mouse, 150
749mk7, Mechanical Keyboard, 45
642uc9, USB-C, 85
104ls3, Laptop Stand, 46
409HD1, HDMI Cable, 30______________________________________________________________________
🧠 运作原理
mcp_file_service.py 通过以下方式将每个CRUD操作注册为MCP工具 @mcp.tool() 室内装饰师 fastmcp.\ Claude使用自然语言查询通过MCP层访问这些工具，例如：
“给我看看所有产品及其数量。”
“总共有多少个USB？”
MCP运行时将这些转换为幕后对Python函数的调用。
______________________________________________________________________