Metatools MCP

MCPAI代理

提供方 jonwraymond

AI代理 未标注 会话登录 社区 / 第三方 Claude DesktopClaude

一个基于MCP协议的元工具服务器,提供工具发现、检查和执行功能,适用于多种部署场景。

一句话选型结论

按资料字段整理

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

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

工具与能力

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

能力标签

支持客户端

适用场景

工具发现Go本地部署工具执行MCP协议开发工具服务器

安装与配置

未标注 会话登录
上游未给出传输方式
  1. 1
    准备运行环境

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

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

    连接成功后客户端会列出约 14 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

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

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

多步任务编排

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

自动化重复流程

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

选择建议

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

值得选的地方

  • 资料标注 14 个工具,覆盖面较广,能满足多种调用。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好会话登录对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Metatools MCP当前 14 未标注 未标注 无 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代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方jonwraymond上游标注的维护方 jonwraymond
分类AI代理本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式会话登录远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

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

元工具mcp

MCP第一个组成整合工具库的“元工具”服务器:

  • toolfoundation/model:规范的MCP对齐工具定义和ID
  • toolfoundation/adapter:协议无关的格式转换
  • tooldiscovery/index:全局注册表+渐进式发现(搜索/命名空间)
  • tooldiscovery/tooldoc:渐进式文档层次+示例
  • tooldiscovery/search:可选搜索策略(例如BM25)
  • toolexec/run:后端无关执行+链接
  • toolexec/code:可选代码样式编排(引擎/运行时支持)
  • toolexec/runtime:建议任何代码执行的沙盒/运行时边界
  • toolops/observe:可选的可观察性中间件
  • toolops/cache:可选缓存中间件

此服务器展示了一个小型的、固执己见的MCP工具界面,用于优化
渐进式披露:

  1. 廉价地发现工具,
  2. 那么,只检查你需要的东西
  3. 以一致的错误语义执行。

MCP工具暴露

发现:

  • search_tools (便宜,BM25/词汇超过聚合索引)
  • list_tools (分页库存;可按后端过滤)
  • list_namespaces (分页命名空间)

检查:

  • describe_tool (渐进细节级别)
  • list_tool_examples
  • list_toolsets, describe_toolset
  • list_skills, describe_skill, plan_skill

执行:

  • run_tool (发送到本地/提供商/MCP后端)
  • run_chain (使用可选数据传递的顺序工具执行)
  • run_skill (受保护的预注册工作流)
  • execute_code (仅当启用并注入执行器时)

更新日志

看 CHANGELOG.md 发布说明。

运输选择

metatools-mcp支持不同部署场景的多种传输方式:

运输 命令 用例
stdio metatools serve Claude Desktop,本地CLI(默认)
streamable metatools serve --transport=streamable --port=8080 Web应用程序、远程客户端(建议用于HTTP)
sse metatools serve --transport=sse --port=8080 旧版web客户端(已弃用)

流式HTTP 通过会话管理实现MCP规范2025-11-25
Mcp-Session-Id header,支持SSE流和JSON响应。```bash

Basic HTTP server

metatools serve --transport=streamable --port=8080

With TLS

metatools serve --transport=streamable --port=443 --tls --tls-cert=cert.pem --tls-key=key.pem

Stateless mode (serverless/FaaS)

metatools serve --transport=streamable --port=8080 --stateless


看 `docs/usage.md` 查看完整配置选项。

## 搜索策略

默认情况下,元工具mcp使用词汇搜索。对于BM25排名:

1. 使用toolsearch标签构建:```bash
go build -tags toolsearch ./cmd/metatools
  1. 设置环境变量:```bash
    METATOOLS_SEARCH_STRATEGY=bm25 ./metatools

笔记:

- BM25需要 `toolsearch` 构建标签。如果你设置
`METATOOLS_SEARCH_STRATEGY=bm25` 没有它,服务器现在很快就会发生故障。
- `METATOOLS_SEARCH_STRATEGY` 不区分大小写(例如, `BM25` 作品)。

## 秘密

元工具mcp可以解决 `secretref::` 通过启动时的值
`toolops/secret` 解析器(在严格模式下快速失效)。这是为了
后端URL和HTTP标头值。

Bitwarden Secrets Manager可作为名为 `bws` 通过
`toolops-integrations` (使用env变量配置,如 `${BWS_ACCESS_TOKEN}` 和
`${BWS_ORG_ID}`).

看 `docs/usage.md` 用于配置示例。

### 环境变量

|变量|默认值|描述|
|----------|---------|-------------|
| `METATOOLS_SEARCH_STRATEGY` | `lexical` | `lexical` 或 `bm25` |
| `METATOOLS_SEARCH_BM25_NAME_BOOST` | `3` |BM25名称字段增强|
| `METATOOLS_SEARCH_BM25_NAMESPACE_BOOST` | `2` |BM25命名空间字段增强|
| `METATOOLS_SEARCH_BM25_TAGS_BOOST` | `2` |BM25标签字段增强|
| `METATOOLS_SEARCH_BM25_MAX_DOCS` | `0` |要索引的最大文档数(0=无限制)|
| `METATOOLS_SEARCH_BM25_MAX_DOCTEXT_LEN` | `0` |最大文档文本长度(0=无限制)|
| `METATOOLS_NOTIFY_TOOL_LIST_CHANGED` | `true` |Emit `notifications/tools/list_changed` 关于索引更新|
| `METATOOLS_NOTIFY_TOOL_LIST_CHANGED_DEBOUNCE_MS` | `150` |取消列表更改通知窗口的抖动|

### 传输环境(CLI默认值)

这些应用程序如下 `metatools serve` 当没有明确设置标志时:

|变量|默认值|描述|
|----------|---------|-------------|
| `METATOOLS_TRANSPORT` | `stdio` |运输类型: `stdio`, `streamable`, `sse` |
| `METATOOLS_PORT` | `8080` |HTTP端口 `streamable`/`sse` |
| `METATOOLS_HOST` | `0.0.0.0` |HTTP绑定主机|
| `METATOOLS_CONFIG` |“”|配置文件的路径|

### 交通环境(Koanf配置)

这些被消费 `config.Load` 通过Koanf(文件/env/flags优先):

|变量|默认值|描述|
|----------|---------|-------------|
| `METATOOLS_TRANSPORT_TYPE` | `stdio` |运输类型: `stdio`, `streamable`, `sse` |
| `METATOOLS_TRANSPORT_HTTP_HOST` | `0.0.0.0` |HTTP绑定主机|
| `METATOOLS_TRANSPORT_HTTP_PORT` | `8080` |HTTP端口|
| `METATOOLS_TRANSPORT_HTTP_TLS_ENABLED` | `false` |为HTTP传输启用TLS|
| `METATOOLS_TRANSPORT_HTTP_TLS_CERT` |“”|TLS证书路径|
| `METATOOLS_TRANSPORT_HTTP_TLS_KEY` |“”|TLS密钥路径|
| `METATOOLS_TRANSPORT_STREAMABLE_STATELESS` | `false` |禁用会话管理|
| `METATOOLS_TRANSPORT_STREAMABLE_JSON_RESPONSE` | `false` |更喜欢JSON而不是SSE流|
| `METATOOLS_TRANSPORT_STREAMABLE_SESSION_TIMEOUT` | `30m` |空闲会话清理持续时间|
| `METATOOLS_STATE_RUNTIME_LIMITS_DB` |“”|用于持久执行限制的SQLite文件|

### 运行时环境(toolruntime构建标记)

|变量|默认值|描述|
|----------|---------|-------------|
| `METATOOLS_RUNTIME_PROFILE` | `dev` | `dev` (不安全)或 `standard` (Docker/WASM)|
| `METATOOLS_DOCKER_IMAGE` | `toolruntime-sandbox:latest` |标准配置文件的Docker镜像|
| `METATOOLS_WASM_ENABLED` | `false` |启用WASM后端(wazero)|
| `METATOOLS_RUNTIME_BACKEND` | `docker` |首选标准后端: `docker` 或 `wasm` |

## 可选工具exec/运行时集成

`execute_code` 连接在构建标签后面,因此服务器保持最小
违约。

通过以下方式在本地启用它:```bash
go get github.com/jonwraymond/toolexec@latest
go run -tags toolruntime ./cmd/metatools

如果你正在开发 toolexec 本地:```bash
go mod edit -replace github.com/jonwraymond/toolexec=../toolexec
go run -tags toolruntime ./cmd/metatools


笔记:

- 构建标签启用 `toolexec/runtime`-支持 `toolexec/code.Executor`.
- 默认配置文件为 `dev` (不安全的子流程后端)。
- 如果Docker可用,设置 `METATOOLS_RUNTIME_PROFILE=standard` 启用
强化的Docker后端。
- 用以下命令覆盖Docker镜像 `METATOOLS_DOCKER_IMAGE` (默认值:
`toolruntime-sandbox:latest`).
- 启用WASM后端 `METATOOLS_WASM_ENABLED=true` 并选择它
随着 `METATOOLS_RUNTIME_BACKEND=wasm` (使用wazero)。

## 快速启动(服务器接线)

最小布线使用适配器层和内部传输包:```go
package main

import (
"context"

"github.com/jonwraymond/metatools-mcp/internal/adapters"
"github.com/jonwraymond/metatools-mcp/internal/server"
"github.com/jonwraymond/metatools-mcp/internal/transport"
"github.com/jonwraymond/tooldiscovery/index"
"github.com/jonwraymond/tooldiscovery/tooldoc"
"github.com/jonwraymond/toolexec/run"
)

func main() {
idx := index.NewInMemoryIndex()
docs := tooldoc.NewInMemoryStore(tooldoc.StoreOptions{Index: idx})
runner := run.NewRunner(run.WithIndex(idx))

cfg := adapters.NewConfig(idx, docs, runner, nil) // executor optional
srv, err := server.New(cfg)
if err != nil {
panic(err)
}

// Use stdio for local/CLI clients
tr := &transport.StdioTransport{}
_ = tr.Serve(context.Background(), srv)

// Or use streamable HTTP for web clients
// tr := &transport.StreamableHTTPTransport{
//   Config: transport.StreamableHTTPConfig{Port: 8080},
// }
// _ = tr.Serve(context.Background(), srv)
}

请参阅中的完整工作示例(包括本地工具+文档注册)
examples/basic/main.go.

它是如何组合在一起的

  • MCP表面通过官方SDK实现(mcp.NewServer,
    mcp.AddTool, mcp.CallToolResult{IsError: ...}).
  • internal/adapters 将公共工具库连接到面向处理程序
    接口,而不会将协议细节泄露到库中。
  • 服务器不会绕过库策略:
  • 工具ID来自 toolfoundation/model.Tool.ToolID()
  • 后端选择如下 tooldiscovery/index.DefaultBackendSelector
  • 文档上限和模式派生来自 tooldiscovery/tooldoc
  • 执行/链语义来自 toolexec/run

文档

  • docs/index.md --概述
  • docs/design-notes.md --权衡和错误语义
  • docs/user-journey.md --端到端代理工作流

版本兼容性

看 VERSIONS.md 对于权威的、自动生成的兼容性矩阵。

持续集成

CI在推送和拉取请求上运行 main 并执行:

  • go mod download
  • go vet ./...
  • go test ./...

常见问题

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

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

Metatools MCP 怎么在 Claude Desktop、Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Metatools MCP 收费吗?

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

Metatools MCP 需要 API Key 吗?

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

Metatools MCP 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Metatools MCP 能提供哪些能力?

资料显示约 14 个工具;能力标签包括 工具发现、Go、Claude、开发工具。具体工具清单以官方文档为准。

热门专题

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

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