File Analysis MCP Server

File Analysis MCP Server

site icon
2025.04.17 0
Python文本分析文件管理文件管理
File Analysis MCP Server 是一个基于 Model Context Protocol (MCP) 构建的文本文件分析服务。它提供了一系列文件分析工具,包括文本分析、文件读取和目录浏览等功能。该服务可以与 Claude Desktop 集成,为用户提供更强大的文件分析能力。
View on GitHub

Overview

基本能力

产品定位

File Analysis MCP Server 是一个专门用于文本文件分析的 MCP 服务,旨在为用户提供标准化的文件分析接口。

核心功能

  • 文本分析工具 (analyze_text): 提供词频统计、字符频率分析等功能
  • 文件读取工具 (read_file): 读取文件内容
  • 目录浏览工具 (list_files): 列出指定目录下的文件

适用场景

  • 需要批量分析文本文件内容的场景
  • 需要与 Claude 等 AI 模型集成的文件分析工作流
  • 需要标准化接口访问本地文件的开发场景

工具列表

  1. analyze_text: 提供文本分析功能,如词频统计等
  2. read_file: 读取指定文件内容
  3. list_files: 浏览指定目录下的文件列表

常见问题解答

  • 文件路径问题: 建议始终使用绝对路径
  • 大文件处理: 建议将大文件分块处理
  • 权限问题: 确保 Claude 有访问目标文件的权限

使用教程

使用依赖

  1. 安装 UV 包管理器: MacOS/Linux: bash curl -LsSf https://astral.sh/uv/install.sh | sh Windows: bash powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

  2. 创建并激活虚拟环境: bash uv venv MacOS/Linux: bash source .venv/bin/activate Windows: bash .venv\Scripts\activate

安装教程

  1. 从 GitHub 克隆仓库: bash git clone https://github.com/yourusername/file-analysis-mcp.git cd file-analysis-mcp

  2. 安装依赖: bash uv pip install "mcp[cli]"

或从 PyPI 安装: bash uv pip install file-analysis-mcp

调试方式

使用 MCP Inspector 运行:

uv run mcp dev path/to/your/server/file

Claude Desktop 集成

  1. 确保已安装 Claude Desktop
  2. 修改配置文件:
  3. MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  4. Windows: %AppData%\Claude\claude_desktop_config.json
  5. 添加服务器配置
  6. 重启 Claude Desktop

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。