文件工具服务器

MCP文件工具服务器

一个MCP（模型上下文协议）服务器，为Claude提供文件系统和实用工具。

特性

工具

• 获取时间：获取任何时区的当前时间
• 搜索文件：在目录中按模式搜索文件
• read_file：读取文件内容（可选行数限制）
• list_directory：列出目录内容
• file_info：获取详细的文件/目录信息
• 运行命令：运行安全shell命令（有限集）

资源

• env://system：系统和环境信息

先决条件

• Node.js 18+
• npm或纱线

安装

npm install

用法

发展

npm run dev

生产

npm run build
npm start

检验员测试

npm run inspect

这将打开一个web UI，以交互方式测试您的工具。

连接到克劳德

克劳德代码

增添 ~/.claude/config.json:

{
  "mcpServers": {
    "file-tools": {
      "command": "npx",
      "args": ["tsx", "/absolute/path/to/src/index.ts"]
    }
  }
}

克劳德桌面

添加到您的Claude Desktop配置中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "file-tools": {
      "command": "npx",
      "args": ["tsx", "/absolute/path/to/src/index.ts"]
    }
  }
}

示例提示

连接后，与Claude一起尝试以下操作：

• “东京现在几点了？”
• “查找我项目中的所有TypeScript文件”
• “读取package.json文件”
• “显示src目录中的内容”
• “获取有关此文件的信息：./tsconfig.json”

项目结构

├── src/
│   └── index.ts     # Main MCP server
├── package.json
├── tsconfig.json
└── README.md

技术

• @模型上下文协议/sdk：官方MCP SDK
• 萨德：架构验证
• TypeScript：类型安全

安全说明

• 这 run_command 该工具只允许安全命令的白名单
• 文件操作仅限于进程有权访问的内容
• 考虑在生产环境中以适当的权限运行

许可证

麻省理工学院

文章

阅读完整教程： [链接到Medium文章]