local-stdio-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
local-stdio-mcp
一个最小可运行、可扩展的本地 stdio MCP 服务。
第一阶段内置 3 个工具:
pingechosearch_files
其中 search_files 通过 Everything 命令行工具进行文件名搜索,只作为示例模块,不与主服务耦合。该工具只会在 Windows 平台注册。
目录结构
local-stdio-mcp/
README.md
pyproject.toml
mcp-settings.json.example
server.py
config.py
modules/
everything/
README.md
backend.py
tools.py
shared/
errors.py
schemas.py
utils.py
tests/
test_smoke.pyRelated MCP server: local-mcp
环境准备
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -e .[dev]如果你已经安装了 Everything CLI,可以把 es.exe 放到系统 PATH 中,或者在项目配置文件里指定路径。非 Windows 平台不会暴露 search_files。
配置
在项目根目录创建 mcp-settings.json,内容可参考 mcp-settings.json.example:
{
"tools": {
"ping": true,
"echo": true,
"search_files": true
},
"everything": {
"enabled": true,
"path": "",
"default_limit": 20
}
}说明:
tools.ping控制是否暴露pingtools.echo控制是否暴露echoeverything.enabled控制 Everything 模块总开关tools.search_files控制是否暴露search_fileseverything.path用于指定es.exe路径,支持相对项目根目录的相对路径everything.default_limit控制默认返回条数search_files只有在 Windows 平台且everything.enabled=true且tools.search_files=true时才会注册
启动服务
python server.py该服务使用 stdio 作为 MCP 传输层,适合被支持 MCP 的本地客户端直接拉起。
工具说明
ping
用于检查服务是否存活:
{"ok": true, "message": "pong"}echo
用于验证参数和返回结构:
输入:
{"text": "hello"}输出:
{"ok": true, "text": "hello"}search_files
输入:
{"query": "invoice", "limit": 20}输出:
{
"ok": true,
"backend": "everything",
"items": [
{
"name": "invoice_001.pdf",
"path": "D:\\Work\\invoice_001.pdf"
}
]
}错误输出:
{
"ok": false,
"error_code": "EVERYTHING_UNAVAILABLE",
"message": "Everything backend is unavailable"
}测试
pytestTool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
An MCP server for search and retrieval over a local LanceDB database
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA high-performance Model Context Protocol (MCP) server built for Windows. Leveraging the native Everything SDK, it provides AI models (like Claude, GPT, Gemini) with millisecond-speed file searching, statistical analysis, and disk usage insights.MIT
- AlicenseNot gradedqualityDmaintenanceA lightweight, stdio-based MCP server enabling AI assistants to perform local file system operations like reading, writing, searching, and executing commands.5,198 npmMIT
- AlicenseAqualityDmaintenanceLocal MCP server for searching a voidtools Everything 1.5a index from Codex, Claude, and other MCP clients.28 npmMIT
- FlicenseNot gradedqualityDmaintenanceA production-ready MCP server providing file, system, math, and text utilities through a simple CLI client.-