📦 mcp-client-go

mcp-client-go is a Golang client library for the Model Context Protocol (MCP). It allows developers to register
and interact with various MCP-based services such as Amap (Gaode Maps) using a unified API.

✨ Features

• Easy integration with MCP-compatible services
• Modular support for service types (e.g., Amap, Github, GoogleMap)
• Unified registration and client management
• Simple and intuitive tool execution interface
• Support claude like config file to set mcp server demo
• Provide prompt to trigger mcp
  request doc

📋 Supported Services

🚀 Getting Started

Install

install npx, uvx, docker, and put them to env!

go get github.com/yincongcyincong/mcp-client-go

🧪 Example

client demo
app demo
deepseek demo
openai demo
project

Parallel Search MCP

With Go 1.23.7 or later installed, run from this checkout:

go mod download
go run ./demo/client/parallel

The demo registers parallel.InitParallelMCPClient() using the existing client
API, then calls web_search and web_fetch and prints their results. It connects
to https://search.parallel.ai/mcp over Streamable HTTP without an API key,
npx, uvx, Docker, or an LLM. The free endpoint is rate limited and intended
for exploration and light use. See the Search MCP documentation
for limits and tool parameters. Registration is explicit; other clients are unaffected.

🧱 API Overview

Initialize Clients

conf := clients.InitStdioMCPClient("npx-amap-maps-mcp-server", "npx", []string{
"AMAP_MAPS_API_KEY=" + AmapApiKey,
}, []string{
"-y",
"@amap/amap-maps-mcp-server",
})
/
conf := clients.InitSSEMCPClient("npx-amap-maps-mcp-server", "http://127.0.0.1")
/
conf := clients.InitHttpMCPClient("npx-amap-maps-mcp-server", "http://127.0.0.1")

Register MCP Clients

clients.RegisterMCPClient(context.Background(), []*param.MCPClientConf{conf})

Get MCP Client

client, err := clients.GetMCPClient("npx-amap-maps-mcp-server")
/
client, err := clients.GetMCPClientByToolName("geo_location")

Execute Tools

client.ExecTools(ctx, "tool_name", map[string]interface{}{...})

📄 License

This project is licensed under the MIT License.