mcpshim

概述

MCPShim 是一个基于 Go 的轻量级解决方案，由守护进程 (mcpshimd) 和 CLI 客户端 (mcpshim) 组成，将远程 MCP 服务器与本地 shell 工作流桥接。它在单个位置处理 MCP 生命周期问题，包括会话管理、发现、重试和 OAuth 流程，同时将 MCP 工具作为标准 CLI 命令公开，具有参数映射和结构化 JSON 输出。这消除了脚本或代理中自定义每服务器布线的需要。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• status

  Display MCPShim daemon status

  试试:Check mcpshim status试试:Is the MCPShim daemon running?
• servers

  List registered MCP servers

  试试:Show me all MCP servers试试:List connected MCP servers
• tools

  List tools for all or one server

  试试:Show me all available tools试试:List tools for the GitHub server
• inspect--server s --tool t

  Show detailed schema of a specific tool

  试试:Inspect the search tool for notion试试:Show me details of the GitHub issue creation tool
• call--server s --tool t --arg value

  Execute a tool call with arguments

  试试:Search notion for project roadmaps试试:Create a GitHub issue with title 'Bug found'
• add--name s --url ... [--alias a]

  Register a new MCP endpoint

  试试:Add notion as an MCP server试试:Register a new GitHub server
• set auth--server s --header K=V

  Set authentication headers for a server

  试试:Set auth headers for notion server试试:Add API key for GitHub server
• remove--name s

  Remove a registered server

  试试:Remove the notion server试试:Delete GitHub from MCP servers
• reload

  Reload daemon configuration

  试试:Reload MCPShim configuration试试:Restart daemon with new settings
• login--server s [--manual]

  Complete OAuth login flow for a server

  试试:Login to notion server试试:Start OAuth for GitHub
• history[--server s] [--tool t] [--limit n]

  Show persisted call history

  试试:Show my recent MCP calls试试:Display notion search history
• script[--install] [--dir ~/.local/bin]

  Generate or install shell alias wrappers for tools

  试试:Create shell aliases for MCP tools试试:Install MCP tools as local commands

可对比工具

安装

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

mkdir -p ~/.config/mcpshim
cp configs/mcpshim.example.yaml ~/.config/mcpshim/config.yaml

mcpshimd

mcpshim servers
mcpshim tools --server notion
mcpshim call --server notion --tool search --query "项目"

{
  "mcpServers": {
    "mcpshim": {
      "command": "mcpshimd",
      "args": []
    }
  }
}

FAQ

MCPShim 如何处理认证？

MCPShim 通过守护进程集中处理认证。它支持 OAuth 流程，并在收到 401 响应时自动启动登录。认证头存储在 SQLite 数据库中。

我可以在任何 MCP 服务器上使用 MCPShim 吗？

是的，MCPShim 设计用于任何 MCP 服务器，无论传输方式（HTTP、WebSocket）或认证方法如何。它会使用特定的 URL 和传输协议注册服务器。

mcpshim 对比