Filesystem▌

by anthropic

Learn how to use Python to read a file and manipulate local files safely through the Filesystem API.

Read, write, and manipulate local files through a controlled API.

github stars

★ 80.5K

GitHub Website npm

Token-optimized batch operationsProject root security boundaries10+ files per request

best for

/ AI agents needing safe file access
/ Developers building MCP-enabled tools
/ Automating file operations in projects
/ Code analysis and modification workflows

capabilities

/ Read and write files in batch operations
/ Search file contents with pattern matching
/ List directory contents recursively
/ Create and delete files safely
/ Validate file paths within project boundaries
/ Process multiple files in single requests

what it does

Provides secure filesystem operations for AI agents with batch processing to read, write, and search files while staying confined to your project directory.

about

Filesystem is an official MCP server published by anthropic that provides AI assistants with tools and capabilities via the Model Context Protocol. Learn how to use Python to read a file and manipulate local files safely through the Filesystem API. This server exposes 14 tools that AI clients can invoke during conversations and coding sessions.

how to install

You can install Filesystem in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.

license

NOASSERTION

Filesystem is released under the NOASSERTION license.

readme

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:

🌟 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.
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.

🤝 Third-Party Servers

[!NOTE] The server lists in this README are no longer maintained and will eventually be removed.

🎖️ Official Integrations

Official integrations are maintained by companies building production ready MCP servers for their platforms.

<img height="12" width="12" src="https://www.21st.dev/favicon.ico" alt="21st.dev Logo" /> 21st.dev Magic - Create crafted UI components inspired by the best 21st.dev design engineers.
<img height="12" width="12" src="https://www.2slides.com/images/2slides-red.svg" alt="2slides Logo" /> 2slides - An MCP server that provides tools to convert content into slides/PPT/presentation or generate slides/PPT/presentation with user intention.
<img height="12" width="12" src="https://framerusercontent.com/images/LpSK1tSZweomrAHOMAj9Gea96lA.svg" alt="Paragon Logo" /> ActionKit by Paragon - Connect to 130+ SaaS integrations (e.g. Slack, Salesforce, Gmail) with Paragon’s ActionKit API.
<img height="12" width="12" src="https://invoxx-public-bucket.s3.eu-central-1.amazonaws.com/frontend-resources/adfin-logo-small.svg" alt="Adfin Logo" /> Adfin - The only platform you need to get paid - all payments in one place, invoicing and accounting reconciliations with Adfin.
<img height="12" width="12" src="https://github.com/AgentOps-AI/agentops/blob/main/docs/favicon.png" alt="AgentOps Logo" /> AgentOps - Provide observability and tracing for debugging AI agents with AgentOps API.
<img height="12" width="12" src="https://www.agentql.com/favicon/favicon.png" alt="AgentQL Logo" /> AgentQL - Enable AI agents to get structured data from unstructured web with AgentQL.
<img height="12" width="12" src="https://agentrpc.com/favicon.ico" alt="AgentRPC Logo" /> AgentRPC - Connect to any function, any language, across network boundaries using AgentRPC.
Agentset - RAG for your knowledge base connected to Agentset.
<img height="12" width="12" src="https://www.airwallex.com/favicon.ico" alt="Airwallex Logo" /> Airwallex Developer - Empowers AI coding agents with the tools they need to assist developers integrating with Airwallex APIs
<img height="12" width="12" src="https://aiven.io/favicon.ico" alt="Aiven Logo" /> Aiven - Navigate your Aiven projects and interact with the PostgreSQL®, Apache Kafka®, ClickHouse® and OpenSearch® services
<img height="12" width="12" src="https://www.alation.com/resource-center/download/7p3vnbbznfiw/34FMtBTex5ppvs2hNYa9Fc/c877c37e88e5339878658697c46d2d58/Alation-Logo-Bug-Primary.svg" alt="Alation Logo" /> Alation - Unlock the power of the enterprise Data Catalog by harnessing tools provided by the Alation MCP server.
<img height="12" width="12" src="https://i.postimg.cc/5NYw9qjS/alby-icon-head-yellow-500x500.png" alt="Alby Logo" /> Alby Bitcoin Payments - Connect any bitcoin lightning wallet to your agent to send and receive instant payments globally with your agent.
Algolia - Use AI agents to provision, configure, and query your Algolia search indices.
<img height="12" width="12" src="https://img.alicdn.com/imgextra/i4/O1CN01epkXwH1WLAXkZfV6N_!!6000000002771-2-tps-200-200.png" alt="Alibaba Cloud AnalyticDB for MySQL Logo" /> Alibaba Cloud AnalyticDB for MySQL - Connect to an AnalyticDB for MySQL cluster for getting database or table metadata, querying and analyzing data. It will be supported to add the OpenAPI for cluster operation in the future.
<img height="12" width="12" src="https://github.com/aliyun/alibabacloud-adbpg-mcp-server/blob/master/images/AnalyticDB.png" alt="Alibaba Cloud AnalyticDB for PostgreSQL Logo" /> Alibaba Cloud AnalyticDB for PostgreSQL - An MCP server to connect to AnalyticDB for PostgreSQL instances, query and analyze data.
<img height="12" width="12" src="https://img.alicdn.com/imgextra/i3/O1CN0101UWWF1UYn3rAe3HU_!!6000000002530-2-tps-32-32.png" alt="DataWorks Logo" /> **[Alibaba Cloud DataWorks](https://github.com/aliyun/alib