MCP

🚀 Poly MCP

Poly MCP is a comprehensive MCP (Model Context Protocol) server equipped with 73 tools across 11 modules, including filesystem operations, diagnostics, scripting, time management, network utilities, context handling, git operations, user input, agent - centric version control, session clipboard, and text/data transforms.

✨ Features

1. Filesystem Module

This module offers advanced file and directory operations with snapshot management, search, and bulk editing capabilities:

• fs_read: Read file contents (with optional line ranges).
• fs_write: Write content to files (with optional line ranges).
• fs_move: Move files or directories.
• fs_copy: Copy files or directories recursively.
• fs_create: Create files or directories.
• fs_delete: Delete files or directories.
• fs_move_desktop: Organize items within the Desktop directory.
• fs_find: Search for files with pattern matching.
• fs_ld: Provide a detailed directory listing (similar to ls -la).
• fs_stat: Get file/directory metadata.
• fs_permissions: Get or set Unix file permissions.
• fs_watch: Monitor file/directory changes.
• fs_snapshot: Create timestamped backups with auto - management.
• fs_tree: Display a visual directory tree with depth control and pattern filtering.
• fs_grep: Perform regex content search across files with context lines.
• fs_tail: Read the last N lines of a file.
• fs_replace: Conduct bulk find/replace across files with regex and dry - run support.

2. Diagnostics Module

It enables language - agnostic error and warning detection:

• diagnostics_get: Retrieve errors/warnings for files or projects.
• Automatically detects the appropriate diagnostic tool (such as cargo, tsc, eslint, pylint, etc.).
• Supports Rust, TypeScript/JavaScript, Python, C/C++.
• Parses compiler/linter output into structured JSON.

3. Silent Module

This module focuses on bash scripting and system resource monitoring:

• silent_script: Execute bash scripts with arguments, environment variables, and timeout.
• silent_resources: Monitor GPU/RAM/CPU usage with detailed process info.
• Supports nvidia - smi for GPU monitoring.
• Allows process filtering and sorting by resource usage.

4. Time Module

It is dedicated to time management, scheduling, and timekeeping:

• time_now: Get the current timestamp in multiple formats (Unix, ISO8601, RFC3339, custom).
• time_sleep: Delay execution with a configurable duration.
• time_schedule: An in - memory task scheduler with create/cancel/list/status operations.
• time_timezone: Convert timestamps between IANA timezones and list available timezones.
• time_stopwatch: Named stopwatches with start/stop/lap/reset/status/list functions.
• time_timer: Countdown timers with check/cancel/list options.
• time_alarm: Set alarms by time or offset, and check/cancel/list them.

5. Network Module

This module is for HTTP requests and package registry queries:

• net_fetch: Fetch URLs with automatic HTML to Markdown conversion.
• net_cargo: Query crates.io for Rust package info.
• net_node: Query the npm registry for Node.js packages.
• net_python: Query PyPI for Python packages.
• net_apt: Query APT package information.
• net_ping: Check network connectivity with statistics.

6. Context Module

It is used for token counting and context management for LLMs:

• ctx_context: Track token usage (total/used/left).
• ctx_compact: Compress text using zlib/gzip algorithms.
• ctx_remove: Clear context and reset usage.
• ctx_token_count: Count tokens for various LLM providers (GPT - 4, Claude, etc.).
• ctx_memory_store: Store data in - memory (for the process lifetime).
• ctx_memory_recall: Retrieve stored data.
• ctx_estimate_cost: Estimate API costs for Anthropic, OpenAI, Ollama, GLM.

7. Git Module

It provides complete git operations via libgit2:

• git_status: Show repository status with staged/unstaged/untracked files.
• git_diff: View changes in patch format.
• git_commit: Create commits.
• git_branch: List, create, or delete branches.
• git_checkout: Switch branches or commits.
• git_blame: Show line - by - line authorship.
• git_log: View commit history.
• git_tag: Manage tags (lightweight and annotated).

8. Input Module

This module handles user interaction and notifications:

• input_notify: Send terminal and desktop notifications.
• input_prompt: Provide interactive text prompts (terminal or MCP).
• input_select: Display selection menus (terminal or MCP).
• input_progress: Show progress bars.
• input_clipboard_read: Read from the system clipboard.
• input_clipboard_write: Write to the system clipboard.

9. Gitent Module

It is for agent - centric version control tracking:

• gitent_init: Initialize or connect to a tracking session.
• gitent_status: View session and uncommitted changes.
• gitent_track: Manually track file changes (create/modify/delete/rename).
• gitent_commit: Commit tracked changes with a message.
• gitent_log: View commit history.
• gitent_diff: View differences in unified or structured format.
• gitent_rollback: Rollback to a previous commit (preview mode by default).

It can track file changes, create commits, view history, and perform rollback operations during AI agent operations.

10. Clipboard Module

It offers session - based copy/paste with tagging to save tokens:

• clip_copy_file: Copy text from a file (with optional line ranges) into the session clipboard with a tag.
• clip_copy: Copy arbitrary text directly into the session clipboard with a tag.
• clip_paste_file: Paste tagged content into a file (overwrite/append/prepend/line - replace).
• clip_paste: Retrieve tagged content or list all stored entries with metadata.
• clip_clear: Clear one or all clipboard entries.

11. Transform Module

This module provides text and data processing utilities:

• transform_diff: Compare two texts or files with unified/inline/stats output.
• transform_encode: Encode/decode base64, URL, hex, HTML entities.
• transform_hash: Perform cryptographic hashing (SHA256, SHA512, MD5, BLAKE3) for text or files.
• transform_regex: Conduct regex operations: match, find_all, replace, split, extract capture groups.
• transform_json: Manipulate JSON: pretty - print, minify, validate, query, merge, keys, flatten.
• transform_text: Perform text transforms: case conversion, sort/reverse/unique/trim/number lines, wrap, truncate, stats.
• transform_archive: Create, extract, and list zip and tar.gz archives.

📦 Installation

cargo add poly-mcp

💻 Usage

Poly MCP supports two transport modes: stdio (default) and HTTP server.

Stdio Mode (Default)

Run the server using stdin/stdout (original MCP behavior):

poly-mcp

The server communicates via JSON - RPC 2.0 over stdin/stdout following the MCP protocol. This is useful for piping commands or integrating with tools that expect stdio communication.

Example:

echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | poly-mcp

HTTP Server Mode

Run as an HTTP server on a specific port:

poly-mcp --server --port 3000

Options:

• --server or -s: Enable HTTP server mode.
• --port <PORT> or -p <PORT>: Port to bind to (default: 3000).
• --host <HOST>: Host to bind to (default: 127.0.0.1).

Example usage:

# Start server on default port 3000
poly-mcp --server

# Start server on custom port
poly-mcp --server --port 8080

# Start server on all interfaces
poly-mcp --server --host 0.0.0.0 --port 3000

HTTP Endpoints:

• POST / or POST /jsonrpc: JSON - RPC 2.0 endpoint.
• GET /health: Health check endpoint.

Example HTTP request:

curl -X POST http://localhost:3000/jsonrpc \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "fs_read",
      "arguments": {"path": "/etc/hosts"}
    }
  }'

Health check:

curl http://localhost:3000/health

MCP Protocol Messages

Initialize:

{"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {}}

List Tools:

{"jsonrpc": "2.0", "id": 2, "method": "tools/list", "params": {}}

Call Tool:

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "fs_read",
    "arguments": {
      "path": "/path/to/file.txt"
    }
  }
}

💻 Usage Examples

Read a File

{
  "name": "fs_read",
  "arguments": {"path": "/etc/hosts"}
}

Read Specific Line Ranges

{
  "name": "fs_read",
  "arguments": {
    "path": "/var/log/app.log",
    "lines": [[1, 10], [50, 60]]
  }
}

Write to Specific Line Ranges

{
  "name": "fs_write",
  "arguments": {
    "path": "/tmp/config.txt",
    "content": "# Header v2\nversion=2.0",
    "lines": [[1, 2]]
  }
}

Create a Snapshot

{
  "name": "fs_snapshot",
  "arguments": {
    "path": "/important/project",
    "max_snapshots": 5
  }
}

Run Diagnostics

{
  "name": "diagnostics_get",
  "arguments": {"path": "./src"}
}

Execute Bash Script

{
  "name": "silent_script",
  "arguments": {
    "script": "#!/bin/bash\necho 'Hello World'\nls -la",
    "timeout": 30
  }
}

Monitor Resources

{
  "name": "silent_resources",
  "arguments": {
    "detailed": true,
    "process_filter": "rust"
  }
}

Fetch URL as Markdown

{
  "name": "net_fetch",
  "arguments": {
    "url": "https://example.com",
    "convert_to_markdown": true
  }
}

Get Latest Package Version

{
  "name": "net_cargo",
  "arguments": {
    "crate_name": "tokio",
    "action": "latest"
  }
}

Count Tokens

{
  "name": "ctx_token_count",
  "arguments": {
    "text": "Your text here",
    "model": "gpt-4"
  }
}

Estimate API Cost

{
  "name": "ctx_estimate_cost",
  "arguments": {
    "provider": "anthropic",
    "model": "claude-3-opus",
    "input_tokens": 1000,
    "output_tokens": 500
  }
}

Git Operations

{
  "name": "git_status",
  "arguments": {"path": "."}
}

{
  "name": "git_commit",
  "arguments": {
    "message": "feat: add new feature",
    "author_name": "Developer",
    "author_email": "dev@example.com"
  }
}

Send Notification

{
  "name": "input_notify",
  "arguments": {
    "title": "Build Complete",
    "message": "Your project has been built successfully!",
    "type": "both",
    "urgency": "normal"
  }
}

Clipboard Operations

{
  "name": "input_clipboard_write",
  "arguments": {"content": "Hello from Poly MCP!"}
}

Gitent Operations

{
  "name": "gitent_init",
  "arguments": {"path": "./my-project"}
}

{
  "name": "gitent_track",
  "arguments": {
    "path": "src/main.rs",
    "change_type": "modify",
    "content": "fn main() { println!(\"Updated\"); }",
    "agent_id": "claude"
  }
}

{
  "name": "gitent_commit",
  "arguments": {
    "message": "Updated main function",
    "agent_id": "claude"
  }
}

{
  "name": "gitent_log",
  "arguments": {"limit": 10, "verbose": true}
}

{
  "name": "gitent_rollback",
  "arguments": {
    "commit_id": "abc123...",
    "execute": false
  }
}

📄 License

Licensed under the MIT License.

🤝 Contributing

Contributions are welcome! Please open an issue or submit a pull request.