此服务器由以下机构认证 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/fileClaude桌面集成
当您将文件分析服务器连接到Claude Desktop时,它的真正威力就来了!
使用Claude Desktop进行设置
- 确保已安装Claude Desktop
- 下载自 Claude.ai 如果你没有
- 找到配置文件:
- MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json - 视窗: %AppData%\Claude\claude_desktop_config.json
如果文件不存在,请创建它。
- 添加服务器配置:
适用于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"
]
}
}
}> 重要:将路径替换为克隆存储库的实际绝对路径。不要使用相对路径。
- 重新启动克劳德桌面
- 完全关闭并重新打开应用程序
- 验证连接
- 在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"
]
}
}
}