Skip to main content

MCP server exposing additional filesystem tools.

Project description

Filesystem Extra Tools MCP Server


A Model Context Protocol (MCP) server implementation for file operation such append text/structured text (JSON) for existing files.

License Python Version MCP Protocol


Table of Contents

  1. Overview
  2. Configuration
  3. Available Tools
  4. License

Configuration

Configure the server using environment variables:

Variable Description Default
ALLOWED_DIR Base directory for files modification Required
PROJECT_BOOTSTRAP Directory in project with bootstrap files Required

Available Tools

read_bootstrap_file

Read file that contains initial project values.

read_file_lines

Reads a region from a file between startLine and endLine. Provide an absolute path to a file.

append_file

Creates a file with a given content if it doesn't exists yet - or appends content to the file.
For JSON data - provide a single structured JSON object as a content (without enclosing it into the array or adding any extra delimiters)
Only works within allowed directories.

append_structured_file

Adds a single valid JSON object to the file. The file is treated as an list of JSON objects.
Pass a file name and a single valid JSON object as a content.
Creates a file with a proper structure if not exists yet. Only works within allowed directories.

search_files_by_regex

Recursively search for files and directories for entries matching a regular expression.
Searches through all subdirectories from the starting path. Returns full paths to all matching items as a JSON array. Only searches within allowed directories.

License

This project is licensed under the MIT License - see the LICENSE file for details.


For more information or support, please open an issue on the project repository.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mcp_filesystem_extra-0.0.2.tar.gz (27.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mcp_filesystem_extra-0.0.2-py3-none-any.whl (7.1 kB view details)

Uploaded Python 3

File details

Details for the file mcp_filesystem_extra-0.0.2.tar.gz.

File metadata

  • Download URL: mcp_filesystem_extra-0.0.2.tar.gz
  • Upload date:
  • Size: 27.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.5

File hashes

Hashes for mcp_filesystem_extra-0.0.2.tar.gz
Algorithm Hash digest
SHA256 72cdfa70aa943e58ebb327572e959376e974903b5d826e2da7d102cb54ba47d4
MD5 71f34db8cd1eaa4850545d6463ee58a2
BLAKE2b-256 3ec85d40995c0adf89f93507dc17a39f07e23ee3a18edb6d24551facd2f6281a

See more details on using hashes here.

File details

Details for the file mcp_filesystem_extra-0.0.2-py3-none-any.whl.

File metadata

File hashes

Hashes for mcp_filesystem_extra-0.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 6a34f7085f742a6a7b6c626c4b571f86bf34386f8ecb3de47bca0bd7aca4c539
MD5 f4fabdb56826718dc0935630327426a4
BLAKE2b-256 fec725e2fef5328980afe299348ac656ed119b71a6f1a1f14e300186c11c36f3

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page