MCP ExplorerExplorer

Mcp Filesystem

@Regan-Milneon 2 days ago
0Β MIT
FreeCommunity
AI Systems

Overview

What is Mcp Filesystem

The Model Context Protocol (MCP) is a framework that enables secure and controlled access for Large Language Models (LLMs) to various tools and data sources. This repository provides reference implementations and community-built servers, showcasing the versatility and extensibility of MCP in enhancing LLM functionality.

Use cases

MCP can be applied in numerous scenarios, such as AI-driven image generation, web content fetching, database interaction, and project management through integration with platforms like Slack, AWS, and Google Drive. It facilitates LLMs in executing tasks across diverse domains including knowledge retrieval, automation, and data analysis.

How to use

MCP servers can be easily utilized with command line tools. Typescript-based servers can be launched using npx, while Python-based servers can be started with uvx or pip. Users can also configure their MCP clients (like Claude Desktop) to integrate various servers by specifying their commands and arguments in a JSON configuration format.

Key features

Key features of MCP include enabling dynamic access to external resources, controlled data operations, and secure integrations with APIs. The protocol supports structured workflows and logging, allowing for efficient collaboration between LLMs and the specified tools, tailored to user needs.

Where to use

MCP can be used in diverse environments including development settings for LLM applications, enterprise applications for task automation, and academic research for exploring model capabilities. It is suitable for projects requiring data-driven decision-making, real-time information retrieval, and integration with popular software platforms.

Content

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.

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.
Each MCP server is implemented with either the Typescript MCP SDK or Python MCP SDK.

🌟 Reference Servers

These servers aim to demonstrate MCP features and the Typescript and Python SDK.

  • AWS KB Retrieval - Retrieval from AWS Knowledge Base using Bedrock Agent Runtime
  • Brave Search - Web and local search using Brave’s Search API
  • EverArt - AI image generation using various models
  • 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
  • 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
  • Memory - Knowledge graph-based persistent memory system
  • PostgreSQL - Read-only database access with schema inspection
  • Puppeteer - Browser automation and web scraping
  • Sentry - Retrieving and analyzing issues from Sentry.io
  • Sequential Thinking - Dynamic and reflective problem-solving through thought sequences
  • Slack - Channel management and messaging capabilities
  • Sqlite - Database interaction and business intelligence capabilities

🀝 Third-Party Servers

πŸŽ–οΈ Official Integrations

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

  • Axiom Logo Axiom - Query and analyze your Axiom logs, traces, and all other event data in natural language
  • Browserbase Logo Browserbase - Automate browser interactions in the cloud (e.g. web navigation, data extraction, form filling, and more)
  • Cloudflare - Deploy, configure & interrogate your resources on the Cloudflare developer platform (e.g. Workers/KV/R2/D1)
  • Raygun - Interact with your crash reporting and real using monitoring data on your Raygun account
  • Obsidian Markdown Notes - Read and search through your Obsidian vault or any directory containing Markdown notes
  • E2B Logo E2B - Run code in secure sandboxes hosted by E2B
  • Neon - Interact with the Neon serverless Postgres platform
  • Tinybird Logo Tinybird - Interact with Tinybird serverless ClickHouse platform
  • Search1API - One API for Search, Crawling, and Sitemaps
  • Qdrant - Implement semantic memory layer on top of the Qdrant vector search engine

🌎 Community Servers

A growing set of community-developed and maintained servers demonstrates various applications of MCP across different domains.

Note: Community servers are untested and should be used at your own risk. They are not affiliated with or endorsed by Anthropic.

  • MCP Installer - This server is a server that installs other MCP servers for you.
  • NS Travel Information - Access Dutch Railways (NS) real-time train travel information and disruptions through the official NS API.
  • Spotify - This MCP allows an LLM to play and use Spotify.
  • Inoyu - Interact with an Apache Unomi CDP customer data platform to retrieve and update customer profiles
  • Snowflake - This MCP server enables LLMs to interact with Snowflake databases, allowing for secure and controlled data operations.
  • MySQL - MySQL database integration with configurable access controls and schema inspection
  • MSSQL - MSSQL database integration with configurable access controls and schema inspection
  • BigQuery (by LucasHild) - This server enables LLMs to inspect database schemas and execute queries on BigQuery.
  • BigQuery (by ergut) - Server implementation for Google BigQuery integration that enables direct BigQuery database access and querying capabilities
  • Todoist - Interact with Todoist to manage your tasks.
  • Tavily search - An MCP server for Tavily’s search & news API, with explicit site inclusions/exclusions
  • Linear - Allows LLM to interact with Linear’s API for project management, including searching, creating, and updating issues.
  • Playwright - This MCP Server will help you run browser automation and webscraping using Playwright
  • AWS - Perform operations on your AWS resources using an LLM
  • LlamaCloud (by marcusschiesser) - Integrate the data stored in a managed index on LlamaCloud
  • Any Chat Completions - Interact with any OpenAI SDK Compatible Chat Completions API like OpenAI, Perplexity, Groq, xAI and many more.
  • Windows CLI - MCP server for secure command-line interactions on Windows systems, enabling controlled access to PowerShell, CMD, and Git Bash shells.
  • OpenRPC - Interact with and discover JSON-RPC APIs via OpenRPC.
  • FireCrawl - Advanced web scraping with JavaScript rendering, PDF support, and smart rate limiting
  • AlphaVantage - MCP server for stock market data API AlphaVantage
  • Docker - Integrate with Docker to manage containers, images, volumes, and networks.
  • Kubernetes - Connect to Kubernetes cluster and manage pods, deployments, and services.
  • OpenAPI - Interact with OpenAPI APIs.
  • Pandoc - MCP server for seamless document format conversion using Pandoc, supporting Markdown, HTML, and plain text, with other formats like PDF, csv and docx in development.
  • HuggingFace Spaces - Server for using HuggingFace Spaces, supporting Open Source Image, Audio, Text Models and more. Claude Desktop mode for easy integration.
  • ChatSum - Query and Summarize chat messages with LLM. by mcpso
  • Rememberizer AI - An MCP server designed for interacting with the Rememberizer data source, facilitating enhanced knowledge retrieval.

πŸ“š Resources

Additional resources on MCP.

πŸš€ Getting Started

Using MCP Servers in this Repository

Typescript-based servers in this repository can be used directly with npx.

For example, this will start the Memory server:

npx -y @modelcontextprotocol/server-memory

Python-based servers in this repository can be used directly 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"
      ]
    }
  }
}

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"
      ]
    },
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    },
    "postgres": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "postgresql://localhost/mydb"
      ]
    }
  }
}

MCP Filesystem Server Setup

This repository contains the configuration and setup for connecting the MCP filesystem server to Claude Desktop.

Installation

  1. Install the MCP filesystem server globally:
npm install -g @modelcontextprotocol/server-filesystem
  1. Configure Claude Desktop to use the filesystem server by editing %APPDATA%/Claude/config.json:
{
  "mcpServers": {
    "filesystem": {
      "command": "node",
      "args": [
        "C:\\Users\\USER\\AppData\\Roaming\\npm\\node_modules\\@modelcontextprotocol\\server-filesystem\\dist\\index.js",
        "C:\\Users\\USER\\Desktop"
      ],
      "useStdio": true
    }
  },
  "mcpDebugLogging": true
}

Key Points

  • The server uses stdio mode for communication with Claude Desktop
  • Absolute paths are used to avoid path resolution issues
  • The server is configured to allow access to the Desktop directory

Troubleshooting

If you encounter connection issues:

  1. Make sure Claude Desktop is completely closed
  2. Check the logs in %APPDATA%/Claude/logs/
  3. Restart Claude Desktop to apply configuration changes

πŸ› οΈ 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.

🀝 Contributing

See CONTRIBUTING.md for information about contributing to this repository.

πŸ”’ Security

See SECURITY.md for reporting security vulnerabilities.

πŸ“œ License

This project is licensed under the MIT License - 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!

Tools

No tools

Comments