AI导哈

文件分析MCP服务器

一个基于MCP协议的文件分析服务器，提供文本分析、文件读取和目录浏览功能，适用于与Claude Desktop等LLM工具集成。

  • by JustVarunsai
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 justvarunsai/file_analysis_mcp

使用说明

此服务器由以下机构认证 MCP集线器 并被列为可信MCP服务器。

文件分析MCP服务器

用于文本文件分析的定制MCP（模型上下文协议）服务器，也作为包发布到PyPI。

目录

引言

什么是MCP？

模型上下文协议（MCP）是一种开放协议，它规范了应用程序如何向大型语言模型（LLM）提供上下文。它为像Claude这样的人工智能模型创建了一个一致的界面，以便与外部工具、数据源和服务进行交互。

MCP遵循客户端-服务器架构：

  • MCP主机：启动连接的程序，如Claude Desktop
  • MCP客户端：主机应用程序内的协议客户端
  • MCP服务器：公开功能的轻量级程序（如本程序）
  • 本地数据源：计算机的文件、数据库和服务

为什么选择MCP？

MCP通过提供以下功能帮助您使用LLM构建代理和复杂的工作流：

  • 将AI模型连接到不同数据源的标准化接口
  • 在LLM提供商之间切换的灵活性
  • 安全数据访问的最佳实践

特性

此文件分析MCP服务器提供：

  • 文本分析工具（字数、字符频率等）
  • 文件读取功能
  • 目录列表
  • 通过MCP资源访问文件内容

文本分析工具(analyze_text)

文件读取器工具(read_file)

目录浏览工具(list_files)

从GitHub安装和设置

步骤1：克隆存储库

首先将存储库克隆到本地计算机：

git clone https://github.com/yourusername/file-analysis-mcp.git
cd file-analysis-mcp

步骤2：设置UV包管理器

这个项目使用UV，一个快速的Python包管理器。如果您没有安装它：

对于MacOS/Linux：

curl -LsSf https://astral.sh/uv/install.sh | sh

对于Windows：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

安装UV后，记得重新启动终端。

步骤3：创建虚拟环境

# Create and activate a virtual environment
uv venv

对于MacOS/Linux：

source .venv/bin/activate

对于Windows：

.venv\Scripts\activate

步骤4：安装依赖项

# Install the required dependencies
uv pip install "mcp[cli]"

测试和调试

使用MCP检查器运行：

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

Claude桌面集成

当您将文件分析服务器连接到Claude Desktop时，它的真正威力就来了！

使用Claude Desktop进行设置

  1. 确保已安装Claude Desktop

  2. 找到配置文件:

    • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • 视窗: %AppData%\Claude\claude_desktop_config.json

    如果文件不存在，请创建它。

  3. 添加服务器配置:

    适用于MacOS/Linux:

    {
    "mcpServers": {
        "file-analysis": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/file-analysis-mcp",
                "run",
                "server.py"
            ]
        }
    }
}

    对于Windows:

    {
    "mcpServers": {
        "file-analysis": {
            "command": "uv",
            "args": [
                "--directory",
                "C:\\ABSOLUTE\\PATH\\TO\\file-analysis-mcp",
                "run",
                "server.py"
            ]
        }
    }
}

    重要：将路径替换为克隆存储库的实际绝对路径。不要使用相对路径。

  4. 重新启动克劳德桌面

    • 完全关闭并重新打开应用程序

  5. 验证连接

    • 在Claude界面中查找工具图标（锤子）
    • 单击此图标时，您的工具应显示在列表中

使用服务器的提示

  • 文件路径：始终提供绝对文件路径以获得最佳结果
  • 大文件：将非常大的文件分解为更小的块进行分析
  • 权限：确保Claude有权访问您正在分析的文件/目录

从软件包安装

来自PyPI（推荐）

安装文件分析MCP服务器的最简单方法是从PyPI：

pip install file-analysis-mcp

或使用紫外线（推荐）：

uv pip install file-analysis-mcp

添加服务器配置

{
  "mcpServers": {
    "mcp-server": {
      "command": "uv",
      "args": [
        "run",
        "mcp-server"
      ]
    }
  }
}

许可证

MIT许可证

相关 MCP