MCPgee
MCPgee
MCPgeeMCPgee

MCPShim

v1.0.0•Developer Tools•stable

Turn remote MCP servers into local command workflows.

aiai-agentsclimcpmodel-context-protocol
Share:
59
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is MCPShim?

MCPShim is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to turn remote mcp servers into local command workflows.

Turn remote MCP servers into local command workflows.

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Turn remote MCP servers into local command workflows.

Use Cases

Convert remote MCP servers to local workflows
Bridge remote and local MCP ecosystems
mcpshim

Maintainer

LicenseMIT
Languagego
Versionv1.0.0
UpdatedMay 12, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx mcpshim

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use MCPShim

MCPShim is a Go-based command-line tool that converts remote MCP servers into local shell commands, making remote AI tool capabilities feel like native CLI programs. It runs a background daemon (mcpshimd) that maintains connections to registered remote MCP servers, while the mcpshim client lets you discover tools, make authenticated calls, and generate shell aliases or standalone executables for any remote tool. DevOps engineers and AI power users use it to integrate remote MCP services into scripts, pipelines, and local workflows without needing a full MCP client application.

Prerequisites

  • Go 1.21+ installed with a configured GOPATH/GOBIN in your PATH
  • At least one remote MCP server URL you want to connect to
  • An MCP client (optional) — MCPShim can also be used standalone from the CLI
  • SQLite is embedded; no separate database installation required
1

Install the MCPShim daemon and client

Install both the daemon (mcpshimd) and the CLI client (mcpshim) using Go's package manager.

go install github.com/mcpshim/mcpshim/cmd/mcpshimd@latest
go install github.com/mcpshim/mcpshim/cmd/mcpshim@latest
2

Create the configuration directory and copy the example config

MCPShim looks for its config file at ~/.config/mcpshim/config.yaml by default. Copy the example config to get started.

mkdir -p ~/.config/mcpshim
cp $(go env GOPATH)/pkg/mod/github.com/mcpshim/mcpshim*/configs/mcpshim.example.yaml \
   ~/.config/mcpshim/config.yaml
3

Start the background daemon

Launch mcpshimd in the background. It manages connections to registered MCP servers and stores call history in SQLite at ~/.local/share/mcpshim/mcpshim.db.

mcpshimd &
# Or with debug logging:
mcpshimd --debug &
4

Register a remote MCP server

Add a remote MCP server by name and URL, then configure any required authentication headers.

mcpshim add --name myserver --url https://example.com/mcp
mcpshim set auth --server myserver --header "Authorization=Bearer YOUR_TOKEN"
5

Discover tools and make your first call

List available tools on the registered server, then call one with mapped CLI flags.

# List tools:
mcpshim list tools --server myserver

# Call a tool:
mcpshim call --server myserver --tool search --query "machine learning" --limit 5
6

Generate shell aliases for native-feeling commands

MCPShim can generate shell function wrappers so remote tools feel like local commands. Add the output to your shell profile.

eval "$(mcpshim script)"
# Now you can call tools directly:
myserver search --query "machine learning"

MCPShim Examples

Client configuration

MCPShim is a standalone CLI tool, not an MCP server itself. Configure it via its YAML config file at ~/.config/mcpshim/config.yaml.

{
  "mcpServers": {
    "mcpshim": {
      "command": "mcpshim",
      "args": ["serve"],
      "env": {
        "MCPSHIM_CONFIG": "/Users/you/.config/mcpshim/config.yaml"
      }
    }
  }
}

Prompts to try

Example MCPShim CLI commands for working with remote MCP servers.

- mcpshim list servers
- mcpshim list tools --server myserver
- mcpshim call --server myserver --tool get_weather --location "New York"
- mcpshim history --server myserver --limit 20
- eval "$(mcpshim script)" && myserver search --query "projects"

Troubleshooting MCPShim

mcpshim: command not found after go install

Ensure $(go env GOPATH)/bin is in your PATH. Add export PATH=$PATH:$(go env GOPATH)/bin to your ~/.bashrc or ~/.zshrc and reload your shell.

Daemon fails to start or socket error

The daemon uses a Unix socket at $XDG_RUNTIME_DIR/mcpshim.sock by default. If XDG_RUNTIME_DIR is not set, specify a socket path explicitly: mcpshimd --socket /tmp/mcpshim.sock. Ensure only one daemon instance is running at a time.

Authentication header not being sent to remote server

Use mcpshim set auth --server <name> --header 'Authorization=Bearer TOKEN' to store credentials. Verify with mcpshim list servers to confirm the server entry. For OAuth flows, consult the mcpshim auth documentation for the correct flow setup.

Frequently Asked Questions about MCPShim

What is MCPShim?

MCPShim is a Model Context Protocol (MCP) server that turn remote mcp servers into local command workflows. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install MCPShim?

Follow the installation instructions on the MCPShim GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with MCPShim?

MCPShim works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is MCPShim free to use?

Yes, MCPShim is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

MCPShim Alternatives — Similar Developer Tools Servers

Looking for alternatives to MCPShim? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.

Ecc

★ 188.2k

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

Javaguide

★ 155.8k

Java 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发

Gemini CLI

★ 104.5k

A secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in

Awesome MCP Servers

★ 87.3k

⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.

MCP Servers

★ 86.0k

Model Context Protocol Servers

CC Switch

★ 77.5k

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Developer ToolsBrowse All Servers

Quick Config Preview

{ "mcpServers": { "mcpshim": { "command": "npx", "args": ["-y", "mcpshim"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use MCPShim?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides