Poly MCP

A comprehensive MCP (Model Context Protocol) server with extensive tooling for filesystem operations, diagnostics, scripting, time management, network utilities, context handling, git operations, and user input.

Features

1. Filesystem Module

Advanced file and directory operations with snapshot management:

• 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 Desktop directory
• fs_find - Search for files with pattern matching
• fs_ld - Detailed directory listing (like 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

2. Diagnostics Module

Language-agnostic error and warning detection:

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

3. Silent Module

Bash scripting and system resource monitoring:

• silent_script - Execute bash scripts with arguments, env vars, and timeout
• silent_resources - Monitor GPU/RAM/CPU usage with detailed process info
• Supports nvidia-smi for GPU monitoring
• Process filtering and sorting by resource usage

4. Time Module

Time management and task scheduling:

• time_now - Get current timestamp in multiple formats (Unix, ISO8601, RFC3339, custom)
• time_sleep - Delay execution with configurable duration
• time_schedule - In-memory task scheduler with create/cancel/list/status operations

5. Network Module

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 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

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 (process lifetime)
• ctx_memory_recall - Retrieve stored data
• ctx_estimate_cost - Estimate API costs for Anthropic, OpenAI, Ollama, GLM

7. Git Module

Complete git operations via libgit2:

• git_status - Repository status with staged/unstaged/untracked files
• git_diff - View changes with 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

User interaction and notifications:

• input_notify - Send terminal and desktop notifications
• input_prompt - Interactive text prompts (terminal or MCP)
• input_select - Selection menus (terminal or MCP)
• input_progress - Display progress bars
• input_clipboard_read - Read from system clipboard
• input_clipboard_write - Write to system clipboard

Installation

cargo add poly-mcp

Usage

Run the MCP server:

poly-mcp

The server communicates via JSON-RPC 2.0 over stdin/stdout following the MCP protocol.

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"
    }
  }
}

Example Tool Calls

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!"}
}

License

Licensed under the MIT License.

Contributing

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