AI导哈

CSV文件管理服务

一个通过MCP协议实现CRUD操作的CSV文件管理服务，可与Claude Desktop集成，支持自然语言操作。

  • by Pavi-NP
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Pavi-NP/test-mcp-Claude

使用说明

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"
      ]
    }
  }
}

编辑配置后：

  1. 彻底退出克劳德(Cmd+Q 在macOS上）。
  2. 等几秒钟。
  3. 重新打开克劳德桌面。
  4. 确认连接器上的连接（适用于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函数的调用。

相关 MCP