# mcpGoSource

**Repository Path**: llqhz/mcp-go-source

## Basic Information

- **Project Name**: mcpGoSource
- **Description**: mcp project tool start.
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-19
- **Last Updated**: 2025-07-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


## Golang MCP 项目

### 原理图

<img height="100%" width="100%" alt="原理图" src="./dist/images/diagram.png">




```text
graph TD

    A[应用服务] -->|输入需求/自然语言请求| B[LLM-Model]
    
    subgraph langchaingo
        B -->|生成工具调用指令| C[LLM-Tool]
    end
    C -->|转发工具调用请求| D
    
    subgraph mcp-go
    D
    end
    
    subgraph 云服务
    E
    end
    
    D -->|MCP协议请求| E[MCP-Server]
    E -->|执行具体功能/返回结果| D[MCP-Client]
    D -->|解析MCP返回结果| C
    C -->|结果整理/格式化| B
    B -->|生成自然语言响应| A
```

### 代码结构

```text
.
|__mcpGoSource
|  |__common
|  |  |__consts
|  |  |  |__consts.go
|  |__mcpclients
|  |  |__weather.go
|  |  |__weather_test.go
|  |__llmtools
|  |  |__weather.go
|  |__go.mod
|  |__go.sum
|  |__main.go
|  |__README.md
```

说明: 
- common 定义常量,包括openAi模型的调用信息
- mcpclients 实现mcp客户端,调用mcp服务,得到并解析天气信息
- llmtools 实现llm的tool,调用mcp客户端,得到mcp服务的响应,并解析给大模型
- main.go 入口函数,实现注册工具给大模型,调用大模型,得到响应

### 实现步骤

#### (一) 大模型Api调用

1. 开通阿里百炼大模型

开通地址: https://bailian.console.aliyun.com/#/home

2. 创建OpenAi兼容服务的密钥

密钥地址: https://bailian.console.aliyun.com/?tab=model#/api-key

#### (二) 高德地图Api

1. 注册高德开发者

注册地址: https://lbs.amap.com/

2. 完成个人开发者认证

认证地址: https://console.amap.com/dev/user/permission

3. 创建应用和密钥:

密钥地址: https://console.amap.com/dev/key/app


#### (三) MCP服务广场-创建MCP服务

1. 注册modelscope账号

注册地址: https://www.modelscope.cn/mcp

2. 创建个人的高德mcp服务

创建地址: https://www.modelscope.cn/mcp/servers/@amap/amap-maps

> 说明: 点击右侧: 通过SSE-URL连接服务, 填写上一步"高德地图Api"里面的密钥,创建服务即可, 得到的sse的地址即可用于mcp-client调用.