Go MCP Host

MCPAI代理

提供方 d4l-data4life

AI代理 未标注 API Key 社区 / 第三方

基于Go的模型上下文协议(MCP)主机服务,具备AI代理能力,可连接多个MCP服务器并与Ollama(OpenAI兼容的LLM)集成,为用户提供智能代理体验。

一句话选型结论

按资料字段整理

Go MCP Host 属于AI代理类 MCP 服务器,传输方式未标注,API Key,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式未标注 鉴权API Key 部署方式未标注
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

AI代理Go本地部署模型上下文协议LLM集成会话管理生产就绪

安装与配置

未标注 API Key
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 基础信息齐全,可以先按官方文档接入试跑。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好API Key对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Go MCP Host当前 未标注 未标注 未标注 无 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方d4l-data4life上游标注的维护方 d4l-data4life
分类AI代理本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式API Key远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

10.5 KB
来自项目仓库与上游目录的原文,未做删改

go mcp主机

具有AI代理功能的基于Go的模型上下文协议(MCP)主机服务。该服务充当连接到多个MCP服务器的智能代理,与Ollama(兼容OpenAI的LLM)集成,并为用户提供代理AI体验。

特性

  • MCP协议支持:全面实施模型上下文协议

  • Stdio和HTTP传输

  • 工具、资源和提示图元
  • 动态能力协商
  • 通知处理(list_changed事件)

  • AI代理编排:智能推理循环

  • 从MCP资源收集上下文

  • 工具发现和执行
  • 多迭代规划和执行
  • 错误恢复

  • LLM集成:与OpenAI兼容的API

  • Ollama支架开箱即用

  • 流媒体响应
  • 工具执行函数调用

  • 会话管理:完全坚持

  • PostgreSQL支持的对话历史记录

  • 支持多用户身份验证
  • 会话生命周期管理

  • 生产就绪

  • 带有WebSocket流的RESTful API

  • JWT身份验证支持
  • 通过Helm部署Kubernetes
  • 普罗米修斯指标
  • 结构化日志记录

快速开始

选项1:作为独立服务使用

在您的基础设施中将go-mcp主机部署为微服务。

先决条件

  • Ollama本地或远程运行
  • PostgreSQL数据库
  • (可选)用于生产部署的Kubernetes集群

在本地运行```bash

Clone the repository

git clone https://github.com/d4l-data4life/go-mcp-host.git
cd go-mcp-host

Copy and configure

cp config.example.yaml config.yaml

Edit config.yaml to add your MCP servers

Start PostgreSQL

make docker-database

Run the service

make run


该服务将在 `http://localhost:8080`.

#### 部署到Kubernetes```bash
# See detailed deployment guide
cd deploy
cat README.md

# Quick deploy
helm install go-mcp-host ./helm-chart \
-f examples/local/values.yaml \
--namespace mcp-host

看 部署/README.md 获取完整的部署文档。

选项2:用作Go库

将MCP主机功能嵌入到您自己的Go应用程序中。

安装```bash

go get github.com/d4l-data4life/go-mcp-host


#### 基本用法```go
package main

import (
"context"
"fmt"
"log"

"github.com/d4l-data4life/go-mcp-host/pkg/config"
"github.com/d4l-data4life/go-mcp-host/pkg/mcphost"
"github.com/google/uuid"
"gorm.io/driver/postgres"
"gorm.io/gorm"
)

func main() {
// Setup database
db, err := gorm.Open(postgres.Open("host=localhost port=5432 user=mcphost dbname=mcphost password=postgres sslmode=disable"), &gorm.Config{})
if err != nil {
log.Fatal(err)
}

// Create MCP Host
host, err := mcphost.NewHost(context.Background(), mcphost.Config{
MCPServers: []config.MCPServerConfig{
{
Name:    "weather",
Type:    "stdio",
Command: "npx",
Args:    []string{"-y", "@h1deya/mcp-server-weather"},
Enabled: true,
Description: "Weather information server",
},
},
OpenAIBaseURL: "http://localhost:11434",
DB:          db,
})
if err != nil {
log.Fatal(err)
}

// Chat with the agent
response, err := host.Chat(context.Background(), mcphost.ChatRequest{
ConversationID: uuid.New(),
UserID:         uuid.New(),
UserMessage:    "What's the weather in New York?",
})
if err != nil {
log.Fatal(err)
}

fmt.Println(response.Message.Content)
}

运行示例:```bash

Simple library usage

go run examples/simple_library/simple_library.go

Web server integration

go run examples/embed_in_webserver/embed_in_webserver.go

Agent package (mid-level)

go run examples/agent_chat/agent_chat.go

Low-level MCP usage

go run examples/ollama_with_mcp/ollama_with_mcp.go


看 示例/README.md 详细文档。

## 建筑```
┌────────────────────────────────────────────────────┐
│               Frontend (React/API)                 │
└────────────────────────┬───────────────────────────┘
│ HTTP/WebSocket
┌────────────────────────▼───────────────────────────┐
│                   go-mcp-host                      │
│  ┌───────────────────────────────────────────────┐ │
│  │  Agent Orchestrator                           │ │
│  │  - Context gathering                          │ │
│  │  - Tool execution loop                        │ │
│  │  - Response generation                        │ │
│  └───────────┬───────────────────────┬───────────┘ │
│              │                       │             │
│  ┌───────────▼──────────┐  ┌─────────▼──────────┐  │
│  │  MCP Manager         │  │  LLM Client        │  │
│  │  - Session mgmt      │  │  - Ollama API      │  │
│  │  - Client pooling    │  │  - Function calls  │  │
│  └───────────┬──────────┘  └────────────────────┘  │
│              │                                     │
└──────────────┼─────────────────────────────────────┘
│
┌──────────┼──────────┐
│          │          │
┌───▼───┐  ┌───▼───┐  ┌───▼───┐
│ MCP   │  │ MCP   │  │ MCP   │
│Server1│  │Server2│  │Server3│
│(stdio)│  │(HTTP) │  │(stdio)│
└───────┘  └───────┘  └───────┘

配置

MCP服务器

在中配置MCP服务器 config.yaml:```yaml
mcp_servers:

Stdio server example

  • name: weather
    type: stdio
    command: npx
    args:
  • "-y"
  • "@h1deya/mcp-server-weather"
    enabled: true
    description: "Weather information server"

HTTP server example

  • name: my-api
    type: http
    url: "https://api.example.com/mcp"
    mode: batch # HTTP mode: batch (JSON) or stream (SSE)
    headers:
    X-API-Key: "your-api-key"
    forwardBearer: true # Forward user's bearer token
    enabled: true
    description: "My custom MCP server"

### LLM配置

go-mcp-host本机使用OpenAI聊天完成API。配置以下环境变量(或匹配的config.yaml键):

- `OPENAI_API_KEY`
- `OPENAI_BASE_URL` (默认为 `https://api.openai.com/v1`)
- `OPENAI_DEFAULT_MODEL` (默认为 `gpt-4o-mini`)
- `OPENAI_TEMPERATURE`, `OPENAI_MAX_TOKENS`, `OPENAI_TOP_P`, `OPENAI_REQUEST_TIMEOUT`

**使用Olama:** 跑 `ollama serve` 本地,然后设置 `OPENAI_BASE_URL="http://localhost:11434"` (Go SDK会自动附加 `/v1`)然后离开 `OPENAI_API_KEY` 空的。任何与OpenAI兼容的提供者都可以以相同的方式使用。

库用户可以通过提供自定义客户端来绕过内置客户端 `llm.Client` 通过 `mcphost.Config.LLMClient`.

### 环境变量

关键环境变量:

- `PORT` -HTTP端口(默认值:8080)
- `CORS_HOSTS` -允许的CORS来源
- `DB_HOST`, `DB_PORT`, `DB_NAME`, `DB_USER`, `DB_PASS` -数据库连接
- `REMOTE_KEYS_URL` -JWT验证端点(可选)
- `DEBUG` -启用调试日志记录
- `OPENAI_API_KEY`, `OPENAI_BASE_URL`, `OPENAI_DEFAULT_MODEL` -LLM配置

看 config.example.yaml 对于所有选项。

## API文档

### REST端点

- `POST /api/v1/auth/register` -注册新用户
- `POST /api/v1/auth/login` -登录
- `GET /api/v1/conversations` -列出对话
- `POST /api/v1/conversations` -创建对话
- `DELETE /api/v1/conversations/:id` -删除对话
- `POST /api/v1/messages` -发送消息
- `WS /api/v1/messages/stream` -流响应
- `GET /api/v1/mcp/servers` -列出MCP服务器
- `GET /api/v1/mcp/tools` -列出可用工具

看 swagg/api.yml API完整规范。

## 发展

### 先决条件

- 转到1.24+
- Docker&Docker编写
- PostgreSQL
- 奥拉玛
- 戈朗茨棉绒

### 建筑```bash
# Build binary
make build

# Build Docker image
make docker-build

# Run tests
make test

# Run linter
make lint

项目结构```

go-mcp-host/
├── cmd/
│ └── api/ # Main application entry point
├── pkg/
│ ├── agent/ # Agent orchestration logic
│ ├── mcp/ # MCP integration helpers
│ │ ├── helpers/ # Shared utilities (schema conversions, etc.)
│ │ └── manager/ # Session management built on modelcontextprotocol/go-sdk
│ ├── llm/ # LLM integration (Ollama)
│ ├── handlers/ # HTTP handlers
│ ├── models/ # Database models
│ ├── config/ # Configuration
│ ├── auth/ # Authentication
│ ├── server/ # HTTP server setup
│ └── mcphost/ # Public API for library usage
├── deploy/
│ ├── helm-chart/ # Kubernetes Helm chart
│ └── examples/ # Example configurations
├── docs/ # Additional documentation
├── examples/ # Usage examples
├── sql/ # Database migrations
└── swagger/ # API specification


> **注:** 低级MCP协议、客户端和传输实现由官方提供 github/modelcontextprotocol/go-sdk此存储库侧重于该客户端上的编排、缓存和特定于产品的集成。

## 测试```bash
# Run all tests
make test

# Run with coverage
make test-coverage

# Run integration tests (requires running database)
make docker-database
make test-integration

贡献

欢迎投稿!拜托:

  1. 分叉存储库
  2. 创建要素分支(git checkout -b feature/amazing-feature)
  3. 提交您的更改(git commit -m 'Add amazing feature')
  4. 推到分支(git push origin feature/amazing-feature)
  5. 打开拉取请求

代码规范

  • 遵循标准Go惯例
  • 跑 gofmt 和 golangci-lint
  • 为新功能编写测试
  • 更新文档

看 .游标 详细的编码标准。

文档

  • MCP实施指南
  • MCP快速参考
  • 部署指导
  • API规范

MCP资源

  • 模型上下文协议规范
  • MCP架构
  • 可用的MCP服务器

许可证

Apache许可证2.0-请参阅 许可证 了解详情。

致谢

  • 内置 去svc 框架
  • 由官方提供技术支持 OpenAI Go SDK 以及兼容的端点,例如 奥拉玛
  • 实现 模型上下文协议

支持

  • GitHub问题: 报告错误或请求功能
  • 文档: 完整文档

由以下材料制成❤️ 通过Data4Life

常见问题

5 问
答案由本站依据条目字段整理,不引用上游原文
Go MCP Host 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Go MCP Host 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Go MCP Host 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Go MCP Host 需要 API Key 吗?

资料标注需要API Key认证,使用前准备好对应凭据,并按最小权限配置。

Go MCP Host 能提供哪些能力?

资料显示能力标签包括 AI代理、会话管理、Go、生产就绪、模型集成。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。