What is Go Mcp Demo

go-mcp-demo is a demonstration project that implements communication between an MCP Server and an MCP Client, leveraging the capabilities of large language models through Ollama.

Use cases

Use cases include reading SQL files, executing MySQL queries, and integrating natural language processing capabilities into applications for enhanced user interaction.

How to use

To use go-mcp-demo, install the Ollama CLI tool, pull and run the desired model, configure the settings in the config.yml file, and then start both the MCP Client and Server from the command line.

Key features

Key features include integrated MCP Server and Client communication framework, support for executing SQL queries and reading local .sql files using natural language, and inference capabilities using the Ollama local large model.

Where to use

go-mcp-demo can be used in fields such as data analysis, natural language processing, and application development where interaction with databases and language models is required.

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 并返回查询结果

---