go-mcp-demo

该项目基于mark3labs/mcp-go 实现了一个 MCP 服务器 和 MCP 客户端 的通信演示，并结合了 Ollama 激活本地大语言模型，实现了调用自然语言工具的能力。

Bilibili 演示视频

✨ 功能概述

• 集成 MCP 服务器+客户端通信框架
• 支持基于自然语言的执行：
  • 读取本地的 .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. 启动主服务（客户端）

进入主服务目录并运行：

cd cmd/server
go run main.go

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

---

5. 启动 MCP 服务（服务器）

在新的终端启动 MCP 服务：

cd cmd/mcp-server
go run main.go

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

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