About Claude Tools MCP
Claude Tools MCP is an MCP server published by mathematic-inc in the Developer Tools category: mCP server that exposes Claude Code's file and shell tools (bash, read, write, edit, glob, grep) over HTTP for remote use by any MCP client.
The repository has 17 stars and 5 forks, with the last commit 2 days ago. Recent commit activity is the strongest signal that reported issues will get attention.
Install
git clone https://github.com/mathematic-inc/claude-tools-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Claude Tools MCP
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 13 hours ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- ✓Tests presentA test suite exists in the repository.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- !No dynamic code executionSource scan found eval or shell execution. Review how tool inputs reach it before granting credentials.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
Releases
README
Claude Tools MCP Server
An MCP (Model Context Protocol) server that exposes Claude Code's file and shell manipulation tools over HTTP, allowing any MCP client to use these tools remotely.
Features
This server provides the following tools:
- bash: Execute shell commands with timeout support and background execution
- bash_output: Retrieve output from background shell processes
- kill_shell: Terminate background shell processes
- read: Read files with line offset/limit support
- write: Write files to disk
- edit: Perform exact string replacements in files
- glob: Find files using glob patterns
- grep: Search file contents using ripgrep (regex support, multiple output modes)
Installation
From Source
go build -o claude-tools-mcp ./cmd/claude-tools-mcp
With Docker
docker build -t claude-tools-mcp .
docker run -p 8080:8080 claude-tools-mcp
The Dockerfile is self-contained and includes the server's development tools and dependencies.
Usage
Starting the Server
# Default (localhost:8080)
./claude-tools-mcp
# Custom address
./claude-tools-mcp --addr localhost:9000
With Docker
# Default port (8080)
docker run -p 8080:8080 claude-tools-mcp
# Custom port
docker run -e PORT=9000 -p 9000:9000 claude-tools-mcp
Configuration
The server runs in stateless mode, allowing each HTTP request to be handled independently. This enables horizontal scaling and simpler deployment.
Security Features
- Timeout protection: Prevents slowloris attacks with ReadHeaderTimeout and IdleTimeout
- Graceful shutdown: Responds to SIGINT/SIGTERM, allowing in-flight requests to complete
- Path validation: Rejects relative paths to prevent directory traversal
- File size limits: 10MB max file size, ~100k token max output
- Result limits: Maximum 1000 lines for grep/glob results
Architecture
The server uses the MCP Go SDK to expose tools over HTTP. All tools are stateless except for:
- File modification tracking: Detects when files are edited externally
- Background shell management: Tracks long-running bash processes
See CLAUDE.md for detailed architecture documentation.
Development
Running Tests
# All tests
go test ./...
# Specific package
go test ./internal/tools
# Specific test
go test -run TestFunctionName ./internal/tools
Dependencies
- Go 1.25.0+
- MCP Go SDK
- Cobra for CLI
- mimetype for file type detection
- ripgrep (
rg) must be installed for the grep tool
Contributing
Start with a Discussion and wait for a maintainer to review your proposal. If we accept it, a Mathematic maintainer or agent will implement it and open the pull request. When Mathematic implements a proposal, the implementation pull request will link to the Discussion and credit its original author. GitHub only allows Mathematic maintainers, repository collaborators with write, maintain, or admin access, and authorized maintenance agents to create pull requests. See CONTRIBUTING.md for the full process.
Repository
github.com/mathematic-inc/claude-tools-mcp
License
Apache-2.0 License. Copyright (c) Mathematic Inc. See LICENSE for details.
This project is free and open-source work by a 501(c)(3) non-profit. If you find it useful, please consider donating.
README fetched from the repository 13 hours ago. The original is authoritative.