文件系统
效率与工作流编辑精选Filesystem
by Anthropic
Filesystem 是 MCP 官方参考服务器,让 LLM 安全读写本地文件系统。
这个服务器解决了让 Claude 直接操作本地文件的痛点,比如自动整理文档或生成代码文件。适合需要自动化文件处理的开发者,但注意它只是参考实现,生产环境需自行加固安全。
什么是 文件系统?
Filesystem 是 MCP 官方参考服务器,让 LLM 安全读写本地文件系统。
如何使用 文件系统
在终端运行。加 --scope project 可写入项目根目录的 .mcp.json,与团队共享。
claude mcp add --transport stdio filesystem -- npx -y @modelcontextprotocol/server-filesystemREADME
Model Context Protocol servers
This repository is a collection of reference implementations for the Model Context Protocol (MCP), as well as references to community-built servers and additional resources.
[!IMPORTANT] If you are looking for a list of MCP servers, you can browse published servers on the MCP Registry. The repository served by this README is dedicated to housing just the small number of reference servers maintained by the MCP steering group.
[!WARNING] The servers in this repository are intended as reference implementations to demonstrate MCP features and SDK usage. They are meant to serve as educational examples for developers building their own MCP servers, not as production-ready solutions. Developers should evaluate their own security requirements and implement appropriate safeguards based on their specific threat model and use case.
The servers in this repository showcase the versatility and extensibility of MCP, demonstrating how it can be used to give Large Language Models (LLMs) secure, controlled access to tools and data sources. Typically, each MCP server is implemented with an MCP SDK:
- C# MCP SDK
- Go MCP SDK
- Java MCP SDK
- Kotlin MCP SDK
- PHP MCP SDK
- Python MCP SDK
- Ruby MCP SDK
- Rust MCP SDK
- Swift MCP SDK
- TypeScript MCP SDK
🌟 Reference Servers
These servers aim to demonstrate MCP features and the official SDKs.
- Everything - Reference / test server with prompts, resources, and tools.
- Fetch - Web content fetching and conversion for efficient LLM usage.
- Filesystem - Secure file operations with configurable access controls.
- Git - Tools to read, search, and manipulate Git repositories.
- Memory - Knowledge graph-based persistent memory system.
- Sequential Thinking - Dynamic and reflective problem-solving through thought sequences.
- Time - Time and timezone conversion capabilities.
Archived
The following reference servers are now archived and can be found at servers-archived.
- AWS KB Retrieval - Retrieval from AWS Knowledge Base using Bedrock Agent Runtime.
- Brave Search - Web and local search using Brave's Search API. Has been replaced by the official server (
@brave/brave-search-mcp-server). - EverArt - AI image generation using various models.
- GitHub - Repository management, file operations, and GitHub API integration.
- GitLab - GitLab API, enabling project management.
- Google Drive - File access and search capabilities for Google Drive.
- Google Maps - Location services, directions, and place details.
- PostgreSQL - Read-only database access with schema inspection.
- Puppeteer - Browser automation and web scraping.
- Redis - Interact with Redis key-value stores.
- Sentry - Retrieving and analyzing issues from Sentry.io.
- Slack - Channel management and messaging capabilities. Now maintained by Zencoder
- SQLite - Database interaction and business intelligence capabilities.
🚀 Getting Started
Using MCP Servers in this Repository
TypeScript-based servers in this repository can be started with npx.
For example, this will start the Memory server:
npx -y @modelcontextprotocol/server-memory
Python-based servers in this repository can be started with uvx or pip. uvx is recommended for ease of use and setup.
For example, this will start the Git server:
# With uvx
uvx mcp-server-git
# With pip
pip install mcp-server-git
python -m mcp_server_git
Follow these instructions to install uv / uvx and these to install pip.
Using an MCP Client
However, running a server on its own isn't very useful, and should instead be configured into an MCP client. For example, here's the Claude Desktop configuration to use the above server:
{
"mcpServers": {
"memory": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-memory"]
}
}
}
On Windows, wrap npx with cmd /c:
{
"mcpServers": {
"memory": {
"command": "cmd",
"args": ["/c", "npx", "-y", "@modelcontextprotocol/server-memory"]
}
}
}
Additional examples of using the Claude Desktop as an MCP client might look like:
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/files"]
},
"git": {
"command": "uvx",
"args": ["mcp-server-git", "--repository", "path/to/git/repo"]
},
"fetch": {
"command": "uvx",
"args": ["mcp-server-fetch"]
}
}
}
On Windows, apply the same wrapper to the npx-based filesystem entry above by changing its "command" to "cmd" and prepending "/c", "npx" to its existing args. Leave the uvx entries unchanged.
Transports: stdio and Streamable HTTP
An MCP server talks to its client over a transport. The protocol defines two standard ones, and they run very differently:
| Transport | How the server runs | How a client reaches it |
|---|---|---|
| stdio | The client launches the server as a subprocess and talks to it over the process's stdin and stdout. The server opens no port. | A command and args in the client's configuration, as in the examples above |
| Streamable HTTP | The server runs on its own as an HTTP service, and can serve many clients | A URL, such as http://localhost:3001/mcp |
Every server in this repository serves stdio by default, and every one can also serve Streamable HTTP on http://127.0.0.1:3001/mcp (set PORT and HOST to move it): Everything with its streamableHttp argument (its README also covers its deprecated HTTP+SSE transport), and the others with --transport streamable-http, as each server's README shows. Started without one, a server uses stdio, so when you run uvx mcp-server-git or npx -y @modelcontextprotocol/server-memory in a terminal, it opens no port, prints at most a one-line startup notice, and then appears to hang. That is expected: it is waiting for a client to send it messages on stdin. You do not normally start a stdio server yourself; your MCP client starts it from its configuration and stops it when it is done.
To try a server without setting up a client, use the MCP Inspector. Given a stdio server's command, it launches the server for you and lets you browse and call its tools; given a URL, it connects to a running Streamable HTTP server:
# A stdio server: the Inspector launches it
npx @modelcontextprotocol/inspector uvx mcp-server-git
# A Streamable HTTP server: start it first, then connect to its URL
npx @modelcontextprotocol/server-everything streamableHttp # or: uvx mcp-server-time --transport streamable-http
npx @modelcontextprotocol/inspector --transport http --server-url http://localhost:3001/mcp
For more, see the transport layer in the MCP architecture overview, and Transports in the specification.
🛠️ Creating Your Own Server
Interested in creating your own MCP server? Visit the official documentation at modelcontextprotocol.io for comprehensive guides, best practices, and technical details on implementing MCP servers.
📚 Learn More
See ADDITIONAL.md for a curated list of frameworks and resources that simplify building MCP servers and clients.
🤝 Contributing
See CONTRIBUTING.md for information about contributing to this repository.
📦 Releasing
See RELEASING.md for how packages are published (OIDC trusted publishing from CI — no registry tokens) and how to retry a failed publish.
🔒 Security
See SECURITY.md for reporting security vulnerabilities.
📜 License
This project is licensed under the Apache License, Version 2.0 for new contributions, with existing code under MIT - see the LICENSE file for details.
💬 Community
⭐ Support
If you find MCP servers useful, please consider starring the repository and contributing new servers or improvements!
Managed by Anthropic, but built together with the community. The Model Context Protocol is open source and we encourage everyone to contribute their own servers and improvements!
常见问题
文件系统 是什么?
读写和管理本地文件系统中的文件和目录。
如何安装 文件系统?
运行命令:npx -y @modelcontextprotocol/server-filesystem
安装排障(国内网络)
npx 拉包很慢、超时或报 ETIMEDOUT 怎么办?
国内直连 npm 官方源经常超时。把 registry 切到 npmmirror(淘宝镜像)即可。全局切换对所有客户端生效;只想对这个 MCP 生效,就在配置的 env 里加 NPM_CONFIG_REGISTRY。bun 和 pnpm 用各自的写法。
npm config set registry https://registry.npmmirror.comnpx --registry=https://registry.npmmirror.com -y @modelcontextprotocol/server-filesystem"env": {
"NPM_CONFIG_REGISTRY": "https://registry.npmmirror.com"
}pnpm config set registry https://registry.npmmirror.com[install]
registry = "https://registry.npmmirror.com"终端里开了代理,客户端里的 MCP 还是连不上?
从 Dock、开始菜单启动的 Claude Desktop、Cursor 等客户端不会继承终端里 export 的代理变量,MCP 进程拿不到代理。把代理地址写进该 MCP 配置的 env(端口换成你自己的)。注意 Node 自带的 fetch 默认不读 HTTPS_PROXY,Node 24 及以上可再加 NODE_USE_ENV_PROXY=1;仍不行就开代理软件的 TUN / 增强模式。
"env": {
"HTTPS_PROXY": "http://127.0.0.1:7890",
"HTTP_PROXY": "http://127.0.0.1:7890",
"NODE_USE_ENV_PROXY": "1"
}npm config set proxy http://127.0.0.1:7890
npm config set https-proxy http://127.0.0.1:7890报 SyntaxError、fetch is not defined 或 Unsupported engine?
多半是 Node 版本太低。大多数 MCP Server 需要 Node 18 以上,建议用 LTS(20 或 22)。用 nvm 装好后,客户端可能仍在用系统自带的旧 Node:用 which npx 查出完整路径,把配置里的 command 换成这个绝对路径。
node -vnvm install --lts
nvm alias default 'lts/*'which npxWindows 上提示 spawn npx ENOENT 或客户端无法启动?
Windows 下 npx 实际是 npx.cmd,部分客户端不能直接启动它。把 command 改成 cmd,在 args 前面加上 /c 和 npx。
"command": "cmd",
"args": ["/c","npx","-y","@modelcontextprotocol/server-filesystem"]相关 Skills
PDF处理
by anthropics
遇到 PDF 读写、文本表格提取、合并拆分、旋转加水印、表单填写或加解密时直接用它,也能提取图片、生成新 PDF,并把扫描件通过 OCR 变成可搜索文档。
✎ PDF杂活别再来回切工具了,文本表格提取、合并拆分到OCR识别一次搞定,连扫描件也能变可搜索。
技能工坊
by anthropics
覆盖 Skill 从创建到迭代优化全流程:起草能力、补测试提示、跑评测与基准方差分析,并持续改写内容和描述,提升效果与触发准确率。
✎ 技能工坊把技能从创建、迭代到评测串成闭环,方差分析加描述优化,特别适合把触发准确率打磨得更稳。
表格处理
by anthropics
围绕 .xlsx、.xlsm、.csv、.tsv 做读写、修复、清洗、格式整理、公式计算与格式转换,适合修改现有表格、生成新报表或把杂乱数据整理成交付级电子表格。
✎ 做 Excel/CSV 相关任务很省心,能直接读写、修复、清洗和格式转换,尤其擅长把乱七八糟的表格整理成交付级文件。
相关 MCP Server
by microsoft
使用此服务器轻松自动化Web交互。让您的LLM利用结构化可访问性快照在网页上导航、提取数据并执行操作,无需视觉模型即可提升可靠性和性能。
by wonderwhy-er
Desktop Commander 是让 AI 直接执行终端命令、管理文件和进程的 MCP 服务器。
✎ 这工具解决了 AI 无法直接操作本地环境的痛点,适合需要自动化脚本调试或文件批量处理的开发者。它能让你用自然语言指挥终端,但权限控制需谨慎,毕竟让 AI 执行 rm -rf 可不是闹着玩的。
by stickerdaniel
LinkedIn Profile and Job Scraper 是让 Claude 直接抓取 LinkedIn 个人资料、公司信息和职位详情的工具。
✎ 这个服务器解决了招聘和商业调研中手动复制粘贴 LinkedIn 数据的痛点,适合猎头或市场分析师快速获取候选人背景和公司动态。不过,LinkedIn 反爬机制频繁更新,数据稳定性需要持续维护,使用时建议搭配人工验证。