Help us shape the future of Go! Take the 2026 Go Developer Survey

mcpkit

module
v0.8.6 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 23, 2026 License: MIT

README

mcpkit

MCP 工具池——客户端封装/工具目录/建连单飞/自愈与租约管理 —— oagentkit 模块矩阵 tier 1(能力层,依赖 tier0)。

go get github.com/oagentkit/mcpkit
包 职责
mcp MCP 客户端/工具池:工具目录、建连单飞、自愈与租约管理

定位

tier 1 — 能力层,依赖 tier0。

  • 本仓依赖的矩阵内仓:runtime。

外部依赖地板

  • github.com/mark3labs/mcp-go
  • github.com/eino-contrib/jsonschema
  • github.com/cloudwego/eino

与 oekit 的关系

本矩阵(oagentkit,Agent/LLM 编排工具链)依赖 oekit(Open Easy Kit,Go 微服务工具链): oekit/pkg / oekit/concurrency / oekit/logx 等。oekit 是另一套独立矩阵,不是子品牌。

开发

go test ./... -race
go vet ./...
gofmt -l .

规范见 AGENTS.md。

License

MIT

  • 建连必须单飞。 同一 server 的并发建连要合并为一次, 不得每次 Pool.Tools(带 ToolSpec.Allow 白名单)都新建连接。
  • 等待方的 ctx 取消要各自生效,不能干等 leader。
  • 工具注解(mcp.ToolAnnotation)归一时,nil 视为规范缺省,不得当成「无限制」。

Directories

Path Synopsis
cmd
mcp-selfcheck command
Command mcp-selfcheck 在部署机上直接跑 MCP server 自检。
Command mcp-selfcheck 在部署机上直接跑 MCP server 自检。
目录层(批次对标 ZCode「连接时一次 tools/list、注册面全量」adapters/src/mcp): 每条连接建立后仅首次取目录走一次线上 ListTools,此后 Tools() 命中内存缓存; 连接被 evict(列举失败/探活死亡/自愈摘除)时目录随连接一并失效,重建连接后 重新列举。
目录层(批次对标 ZCode「连接时一次 tools/list、注册面全量」adapters/src/mcp): 每条连接建立后仅首次取目录走一次线上 ListTools,此后 Tools() 命中内存缓存; 连接被 evict(列举失败/探活死亡/自愈摘除)时目录随连接一并失效,重建连接后 重新列举。

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL