go-mcp-demo

Patrick7241/go-mcp-demo

3.3

If you are the rightful owner of go-mcp-demo and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

This project demonstrates communication between an MCP Server and MCP Client using a local large language model with natural language tool invocation capabilities.

go-mcp-demo

本项目基于 mark3labs/mcp-go 实现了一个 MCP Server 与 MCP Client 通信的演示，结合 Ollama 启动本地大语言模型，实现自然语言调用工具的能力。

b站演示视频

✨ 功能概览

  • 集成 MCP Server + Client 通信框架
  • 支持基于自然语言执行：
    • 读取本地 .sql 文件
    • 执行任意 MySQL 查询
  • 使用 Ollama 本地大模型进行推理（默认端口：http://localhost:11434）

🚀 快速开始

1. 安装 Ollama

请参考官网：https://ollama.com
根据操作系统下载安装 Ollama CLI 工具。

2. 拉取并运行模型

在命令行中执行以下命令，拉取你需要的模型（示例使用 qwen2:1.5b）：

ollama pull qwen2:1.5b
ollama run qwen2:1.5b

模型将监听本地端口：http://localhost:11434/api/generate

3. 修改配置文件

打开并编辑 pkg/config/config.yml：

ollama:
  model: qwen2:1.5b

mysql:
  host: localhost
  port: 3306
  user: root
  password: your_password
  database: your_database

sql:
  sqlFilePath: E:/your/path/to/test.sql

✅ 注意事项：

  • model 名称需与 ollama pull 和 ollama run 保持一致
  • mysql 信息替换为你本地或远程数据库连接参数
  • sqlFilePath 设置为你希望读取的 .sql 文件绝对路径

4. 启动主服务（Client）

进入主服务目录并运行：

cd cmd/server
go run main.go

默认监听地址：http://localhost:2001

5. 启动 MCP 服务（Server）

在新终端中启动 MCP 服务：

cd cmd/mcp-server
go run main.go

默认监听地址：http://localhost:2002 服务将自动注册以下工具：

  • read_file: 读取指定的 .sql 文件内容
  • query_db: 执行任意 SQL 并返回查询结果