
Grpc Invoke Mcp
io.github.grulex由 GitHub 帳號 grulex 發布v0.1.5更新於 Oct 24, 2026
MCP server for describing and invoking gRPC methods
概覽
本機 MCP 伺服器,讓 AI 助理透過反射或本機 .proto 檔描述 gRPC 服務並呼叫一元 gRPC 方法。
- 可以做什麼
- 檢視 gRPC 服務、方法與訊息型別:列出服務、在呼叫前查看方法簽章與請求結構,可透過伺服器反射或本機 .proto 檔與匯入路徑完成。以 JSON 請求內容呼叫一元 gRPC 方法,可送出自訂中介資料標頭,並透過 TLS 或明文 HTTP/2 連線至本機、預備或生產安全端點。
- 適用情境
- 適合需要讓助理探索 gRPC API、了解請求與回應結構,或在整合與除錯過程中直接發出針對性測試呼叫、而不必撰寫一次性指令碼的情境。
- 執行需求
- 透過 npx 以 stdio 在本機執行,需要 PATH 中有 Node.js 與 npx。npm 套件在安裝時會下載對應平台的二進位檔,需要能存取 GitHub Releases。支援 macOS(Apple Silicon 與 Intel)、Linux x64/ARM64 與 Windows x64/ARM64。目標 gRPC 伺服器需可連線,並開啟反射或提供本機 .proto 檔。
安裝
在 SourceWeft 中
- 開啟 儀表板中的 Grpc Invoke Mcp,將其新增到工作區。
- 為需要使用其工具的對話啟用該服務。
Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。
其他 MCP 客戶端
參照 儲存庫 中的啟動說明。
README
gRPC Invoke MCP
[npm version] [npm downloads] [license]
grpc-invoke-mcp is an MCP server for calling gRPC methods from AI agents like Claude Code, Codex, Cursor, and other MCP-compatible tools.
It gives agents a simple way to inspect gRPC APIs and invoke unary RPCs using either server reflection or local .proto files. This is useful when you want an agent to explore services, understand request and response schemas, make real gRPC calls, and test gRPC integrations during agent-driven development without writing one-off scripts.
Features
- Call gRPC methods from MCP-compatible agents
- Describe gRPC services, methods, and message types
- Use server reflection or local
.protofiles - Connect over TLS or plaintext HTTP/2
- Send custom metadata headers
- Pass JSON request bodies for unary RPCs
- Works with Claude Code, Codex, Cursor, and other MCP clients
Installation
Run the server with npx:
The package downloads a platform-specific grpc-invoke-mcp binary during installation.
Agent Setup
Claude Code
Project config file: .mcp.json
Optional CLI setup:
Codex
User config file: ~/.codex/config.toml
Optional CLI setup:
Cursor
Project config file: .cursor/mcp.json
You can also install it globally in ~/.cursor/mcp.json.
Available Tools
grpc_describe
Use this tool to inspect services, methods, and message types.
Common use cases:
- list services exposed by a gRPC server
- inspect a method signature before calling it
- explore message schemas through reflection
- describe APIs from local
.protofiles
grpc_call
Use this tool to invoke unary gRPC methods with a JSON request body.
Common use cases:
- call internal microservices from your agent
- test request and response payloads
- send auth headers or other gRPC metadata
- connect to local, staging, or production-safe endpoints
Example Prompts
- "Describe the services exposed by
localhost:50051using reflection." - "Show the request schema for
helloworld.Greeter/SayHello." - "Call
helloworld.Greeter/SayHelloonlocalhost:50051with{ \"name\": \"World\" }." - "Invoke
package.Service/Methodusingproto_filesandimport_pathsinstead of reflection."
How It Works
This package exposes an MCP server over stdio. Your agent starts it locally and discovers tools such as:
grpc_describefor schema inspectiongrpc_callfor unary RPC invocation
Under the hood, the npm package launches a native grpc-invoke-mcp binary bundled at install time. The binary supports:
- gRPC server reflection
- local
.protodefinitions - plaintext or TLS connections
- request metadata headers
Supported Platforms
The installer currently targets:
- macOS Apple Silicon
- macOS Intel
- Linux x64
- Linux ARM64
- Windows x64
- Windows ARM64
Troubleshooting
npx cannot start the server
Make sure Node.js and npx are installed and available in your PATH.
The binary download fails
The npm package downloads a release artifact during installation, so your machine needs network access to GitHub Releases.
Reflection does not work
If the target server does not expose gRPC reflection, use local .proto files and import_paths instead.
TLS or connection errors
Check the target host, port, TLS settings, and whether the server expects plaintext or TLS.
The agent does not use the MCP server
Confirm the config file is in the right location for your client, restart the client if needed, and verify the server appears in the MCP list or tools panel.
Why Use grpc-invoke-mcp
If you work with gRPC services, this MCP server lets AI agents inspect and call those services directly. Instead of translating API details by hand, you can let Claude Code, Codex, Cursor, or other MCP-compatible agents explore the contract and execute safe, targeted requests for debugging, integration work, API discovery, and gRPC testing in agent-driven development workflows.
License
MIT
來源:README.md,提交 f7fced0
工具
0版本歷史
1- v0.1.5最新Sep 16, 2026
評分
已滿足適用檢查項的 50%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
- 近 30 天內可連通25 分
請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。
- 已宣告認證方式10 分
請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。
- 已列出工具15 分
請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。
- 描述必需15 分
- 圖示10 分
- 文件15 分
- 授權條款10 分