Skip to main content

GIA File Tools — MCP Server

A Model Context Protocol (MCP) server that exposes secure, sandboxed file operations to AI agents.

Tools Provided (10 total)

Tool Description
read_file Read the exact content of a text or code file
read_file_summarized Read a large file from storage with context pruning to fit within token limits
write_file Create a new file or completely overwrite an existing one (atomic write)
replace_text Search-and-replace a block of text inside a file (supports fuzzy whitespace matching)
batch_replace Replace multiple blocks of text in a file in one single operation
delete_file Delete a single file
delete_directory Delete a directory and all files within it
list_directory List files and folders in a directory
search_files Grep-like search across files for a string or regex pattern
get_file_structure Recursive tree view of a directory structure

All paths are sandboxed to a root directory (set GIA_FILE_ROOT env var, defaults to cwd).

Local Development

# Install in dev mode
cd mcp/uvx
pip install -e .

# Run directly
gia-file-tools

# Test via uvx (from project root)
uvx --from ./mcp/uvx gia-file-tools

Publish to PyPI

cd mcp/uvx

# Build
pip install build
python -m build

# Upload (needs PyPI API token)
pip install twine
twine upload dist/*

After publishing, anyone can run:

uvx gia-file-tools

Use in GIA Agent System

The GenericMcp class (inheriting from ElectronAwareToolkit) is the native wrapper in the GIA backend.

from ai.functions.mcp import GenericMcp

# Connect to the published MCP server.
# The `conv_id` will automatically configure `GIA_FILE_ROOT` for a remote sandbox.
# If the user is connected via the Electron desktop app, the commands are automatically
# routed via WebSockets to execute locally on their own computer instead!
file_tools = GenericMcp(
    command="uvx",
    args='["gia-file-tools"]', 
    conv_id="abc-123-xyz",
    user=current_user
)

# All 10 tools are inherently registered and schema-aware.

Metadata

Release files for gia-file-tools 0.1.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for gia-file-tools 0.1.2
File Size Uploaded Provenance Actions
gia_file_tools-0.1.2.tar.gz 11.5 kB Without provenance Details for gia_file_tools-0.1.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for gia-file-tools 0.1.2
File Interpreter ABI Platform Actions
gia_file_tools-0.1.2-py3-none-any.whl Python 3 none any Details for gia_file_tools-0.1.2-py3-none-any.whl

Total release size: 23.7 kB

Release files / gia_file_tools-0.1.2.tar.gz

Download URL gia_file_tools-0.1.2.tar.gz
Size 11.5 kB
Tags Source
SHA-256 checksum
How to use checksums
a4babd127cec92cdb658155d4ddb1fc6841740b687d8ac481bd3b26bbbc3f33d
BLAKE2b-256 checksum
How to use checksums
dd262d1e27e8c658ffcf9365408a7014a6275f430523dd8086af8ae92a672dfc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.10.6 {"installer":{"name":"uv","version":"0.10.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / gia_file_tools-0.1.2-py3-none-any.whl

Download URL gia_file_tools-0.1.2-py3-none-any.whl
Size 12.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
840dc47a685d1c8f2ae510de1f0d402529b3560fa07cfa93c2714bb3784cab0e
BLAKE2b-256 checksum
How to use checksums
0a8eb7fb0a728b60ebee53a9aa01c0a2888e14f91fe4866b770b8005c12b0c23
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.10.6 {"installer":{"name":"uv","version":"0.10.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for gia-file-tools 0.1.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page