File Search MCP
File Search MCP 🔍
一个基于 FastMCP 的本地文件搜索 MCP Server。让 Claude 能够递归搜索项目文件内容,快速定位关键词。
功能
Tool(工具)
工具 | 说明 |
| 递归搜索文件内容中的关键词,返回匹配的文件路径、行号和内容 |
| 列出目录中的文件和子目录,支持 glob 过滤 |
Resource(资源)
资源 URI | 说明 |
| 搜索统计:累计搜索次数、最近 20 条搜索记录 |
| 当前配置:文本扩展名白名单、跳过目录、文件大小上限等 |
Related MCP server: Ressl MCP
特性
🧠 智能文件识别 — 白名单扩展名 + 二进制检测(null byte 扫描),避免搜索图片/压缩包/可执行文件
🚫 自动跳过无关目录 — 默认跳过
.git、node_modules、__pycache__、venv等📏 大文件保护 — 自动跳过大于 2MB 的文件,防止卡顿
🔤 大小写可选 — 默认不区分大小写,也可精确匹配
🎯 结果上限 — 默认最多返回 50 条,避免输出爆炸
📋 搜索历史 — 内存中保留最近 20 条搜索记录,可通过 Resource 查看
快速开始
环境要求
Python 3.10+
fastmcp >= 3.0
安装
# 克隆仓库
git clone https://github.com/rubber25ba/file-search-mcp.git
cd file-search-mcp
# 创建虚拟环境(推荐)
python -m venv .venv
# Windows
.venv\Scripts\activate
# macOS/Linux
source .venv/bin/activate
# 安装依赖
pip install fastmcp本地测试
python server.py在 Claude Code 中配置
在 Claude Code 的 settings.json 中添加:
{
"mcpServers": {
"file-search": {
"command": "python",
"args": ["C:/Users/YOUR_USERNAME/path/to/file-search-mcp/server.py"]
}
}
}也可以在 Claude Code 中输入
/config打开配置面板,选择 MCP Servers → Add,填写:
Name:
file-searchCommand:
pythonArgs:
["你的路径/file-search-mcp/server.py"]
配置完成后重启 Claude Code,试试:
「搜索 mcp-projects 目录下提到 FastMCP 的文件」
「列出桌面上所有的 .py 文件」
使用示例
示例 1:搜索代码中的关键词
用户:搜索当前项目里所有提到 "TODO" 的文件
Claude 调用 search_files(keyword="TODO", directory=".", glob_pattern="*.py")
→ 返回所有包含 TODO 的 Python 文件路径、行号和内容示例 2:列出目录结构
用户:桌面上有哪些 Markdown 文件?
Claude 调用 list_directory(path="~/Desktop", glob_pattern="*.md")
→ 列出桌面上所有 .md 文件示例 3:查看搜索统计
用户:我最近搜了什么?
Claude 读取 resource search://stats
→ 返回搜索次数和历史记录配置说明
可以在 server.py 中修改以下常量:
配置 | 默认值 | 说明 |
| 50 | 单次搜索最多返回结果数 |
| 2MB | 跳过的文件大小阈值 |
|
| 跳过搜索的目录名 |
|
| 文本文件扩展名白名单 |
项目结构
file-search-mcp/
├── server.py # MCP Server 主程序(Tool + Resource)
└── README.md # 本文件技术栈
FastMCP — Python MCP Server 框架
MCP (Model Context Protocol) — Anthropic 推出的 AI 工具集成协议
License
MIT
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Flicense-qualityDmaintenanceEnables intelligent file searching in local directories using natural language queries. Supports searching by file type, filename patterns, and content across multiple formats including PDF, Word, Excel, and text files with AI-powered relevance scoring.Last updated
- Flicense-qualityDmaintenanceEnables searching for keywords within files with case-sensitive/insensitive options, returning matching lines with line numbers for easy reference.Last updated
- Flicense-qualityDmaintenanceEnables searching for keywords in files with support for case-sensitive/insensitive matching, returning line numbers, full line content, and match counts for all occurrences.Last updated
- Flicense-qualityDmaintenanceEnables exploration and search of local filesystems using glob pattern matching to find files and grep to search for text patterns within files.Last updated1
Related MCP Connectors
Search your Obsidian vault to quickly find notes by title or keyword, summarize related content, a…
Search, browse, and read your Dropbox files. Find documents by name or content, list folders, and…
Wikimedia Commons file/image/audio/video search via MediaWiki Action API
Appeared in Searches
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/rubber25ba/file-search-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server