1. Conduid
  2. Developer Tools
  3. Mcproxy
MCP server · Developer Tools

Mcproxy

MCP Proxy with tool filtering for Claude Code

Unclaimed MIT last commit 8 months ago devtools
58Fair

Scored 2 days ago · breakdown

About Mcproxy

Mcproxy is an MCP server published by team-attention in the Developer Tools category: mCP Proxy with tool filtering for Claude Code. It has been installed 0 times through Conduid.

The repository has 20 stars and 4 forks, with the last commit 8 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues (0) before depending on it in production.

Install

Install
npx mcproxy

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

Powered by Claude · Grounded in docs

I know everything about Mcproxy. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ·README presentNot checked yet.
  • ·License declaredNot checked yet.
  • ·Tests presentNot checked yet.
  • ·Dependencies pinnedNot checked yet.
  • ·No dynamic code executionNot checked yet.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

Releases

v0.1.0v0.1.0 · 8 Jan 2026Initial release of mcproxy - MCP Proxy with tool filtering for Claude Code.

README

mcproxy

MCP Proxy with Tool Filtering for Claude Code

Intercepts MCP server requests and filters tools based on configuration to reduce token consumption.

License NPM

InstallationUsageConfigurationHow It Works


🎥 Demo

https://github.com/user-attachments/assets/549f05da-75e2-47b8-b100-9aa3b5f1ccec

🚀 Installation

run directly with npx (recommended):

npx @team-attention/mcproxy <upstream-command>

Or install globally:

npm install -g @team-attention/mcproxy

🛠 Usage

Basic Usage

Wrap your MCP server command with mcproxy:

mcproxy npx -y @modelcontextprotocol/server-filesystem /path/to/dir

With Claude Code (.mcp.json)

Configure your .mcp.json to use mcproxy as a wrapper. This allows you to control which tools are exposed to Claude.

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y", "@team-attention/mcproxy",
        "--",
        "npx", "-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"
      ]
    },
    "linear": {
      "command": "npx",
      "args": [
        "-y", "@team-attention/mcproxy",
        "--",
        "npx", "-y", "mcp-remote", "https://mcp.linear.app/mcp",
        "--header", "Authorization: Bearer ${LINEAR_API_KEY}"
      ]
    }
  }
}

⚙️ Configuration

mcproxy automatically creates a .mcproxy.json file in your workspace to manage tool settings.

{
  "version": "1.0",
  "servers": {
    "linear-mcp@1.0.0": {
      "tools": {
        "list_issues": true,
        "create_issue": true,
        "delete_issue": false
      }
    }
  }
}
  • Auto-registration: Tools are automatically added to the config on first use (default: true).
  • Disable Tools: Set any tool to false to block it.
  • Server Identity: Keys are derived from serverInfo.name@version in the MCP initialize response.

🧩 How It Works

graph LR
    A[Claude Code] <-->|stdio| B(mcproxy)
    B <-->|subprocess| C[MCP Server]
    B -.-> D[.mcproxy.json]
    style B fill:#f9f,stroke:#333,stroke-width:2px
  1. Intercept: mcproxy intercepts the MCP initialize response to identify the server.
  2. Filter: On tools/list, it filters out tools marked as false in .mcproxy.json.
  3. Block: On tools/call, it prevents execution of disabled tools.

⚡ Options

Option Description
--config <path> Path to workspace root for .mcproxy.json (default: current directory)

🐞 Debugging

Set DEBUG=1 to enable verbose logging for troubleshooting:

DEBUG=1 mcproxy npx -y @some/mcp-server

License

MIT

README mirrored from the source repository 2 days ago. The original is authoritative.

Questions

About Mcproxy

How do I install Mcproxy?

Run npx mcproxy, then add the server to your MCP client's configuration. Conduid has recorded 0 installs, so the command is known to work with current clients.

Is Mcproxy safe to use with an AI agent?

Its trust score is 58 out of 100 (fair). It passes 0 of 1 static security checks; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Mcproxy still maintained?

The last commit was 8 months ago, with 0 open issues. That's long enough that you should check whether the maintainer is responding to issues before depending on it.