toolbelt (Modulewise)

模块化工具带

A. 模型上下文协议 （MCP）公开的服务器 Wasm组件 作为工具。

这是一个早期的非生产原型。

构建

先决条件：电流 防锈工具链

克隆 可组合mcp 项目，如果你还没有。

然后从内部 composable-mcp 目录：

cargo install --path .

这将构建二进制文件 release 配置文件并添加 将其添加到您的货箱目录中，该目录应位于您的PATH中。

运行简单组件

提供一条或多条路径 .wasm 文件作为命令行参数：

toolbelt hello.wasm calculator.wasm

或者，您可以为已发布的Wasm组件指定OCI URI，例如：

toolbelt oci://ghcr.io/modulewise/demo/hello:0.2.0 \
         oci://ghcr.io/modulewise/demo/calculator:0.2.0

\[！提示\] 如果要在本地构建Wasm组件，请克隆 模块化/演示 项目并遵循中的构建说明 组件/README.md

运行具有依赖关系的组件

默认情况下，组件以最低权限功能模式运行。 如果您的组件需要主机运行时的功能，您可以 在a中指定这些功能 .toml 文件：

[capability.http]
type = "wasi:http"

然后定义导入一个或多个功能的工具组件：

[component.flights]
uri = "file:///path/to/flight-search.wasm"
imports = ["http"]

将定义文件传递给服务器，而不是直接传递 .wasm 文件夹：

toolbelt flights.toml

Wasm Components还可以导入可能有自己依赖关系的其他组件：

components.toml

[component.incrementor]
uri = "../demos/components/lib/incrementor.wasm"
imports = ["keyvalue"]

[component.incrementor.config]
bucket = "increments"

[component.keyvalue]
uri = "../demos/components/lib/valkey-client.wasm"
imports = ["wasip2"]

责任可以在多个文件中分开：

capabilities.toml

[capability.wasip2]
type = "wasi:p2"

现在可以将这些文件传递到服务器：

toolbelt components.toml capabilities.toml

这允许主机功能和客户组件的各种组合。 它还促进了责任驱动的关注点分离 支持基础设施和以领域为中心的工具。

配置MCP服务器

当否 [server] 随着 type = "mcp" 已配置，工具带启动默认值 MCP服务器已打开 127.0.0.1:3001 自动发现顶级组件（那些 未由其他组件进口）。

对于显式控制，添加 [server] 部分与 type = "mcp" 致你的 定义文件。

使用选择器发现要作为工具公开的组件

使用 component-selector 按元数据匹配组件：

[server.mcp]
type = "mcp"
port = 3001
component-selector = "!dependents"

这将所有顶级组件作为工具公开。其他选择器表达式 例如，支持 labels.domain = "shopping" 或 name = "greeter".

明确定义工具

使用 [server.mcp.tool.*] 将特定组件功能映射到的条目 命名工具：

[server.mcp]
type = "mcp"
port = 3001

[server.mcp.tool.greeter]
component = "greeter"
function = "greet"
description = "Greet someone by name"

[server.mcp.tool.adder]
component = "calculator"
function = "operations.add"

工具名称来自TOML键(greeter 和 adder 上文）。 如果指定了函数，则该函数应通过接口进行限定 通过接口导出，或者如果在WIT世界级导出，则直接导出。 这 description 字段是可选的，但在提供 向呼叫代理发送指令。

两者结合

选择器和显式工具可以一起使用。明确的工具定义 优先处理名称冲突：

[server.mcp]
type = "mcp"
port = 3001
component-selector = "!dependents"

[server.mcp.tool.greeter]
component = "greeter"
function = " greet"
description = "Custom description for the greet tool"

原产地验证

工具带验证 Origin 根据MCP规范，请求中是否存在标头。 绑定到环回地址时，默认情况下允许使用localhost源。 否则，除非明确配置，否则所有来源都将被拒绝：

[server.mcp]
type = "mcp"
port = 3001
host = "0.0.0.0"
allowed-origins = ["app.example.com", "localhost"]

OpenTetry跟踪

添加 otlp-endpoint 通过OTLP导出跨度：

[server.mcp]
type = "mcp"
port = 3001
otlp-endpoint = "http://localhost:4317"
otlp-protocol = "grpc"  # or "http/protobuf"; defaults to "grpc"

跨度为 tools/list 和 tools/call 属性如下 gen_ai MCP语义约定跟踪上下文通过从客户端传播到服务器 _meta 在请求参数和从服务器到Wasm组件调用中 traceparent 在传播背景下。

看 示例/酒店 以Jaeger为例。

使用MCP检查员进行测试

1. 如上所述运行服务器。

1. 启动 MCP检查员.

1. 确保 Streamable HTTP 已选择传输类型。

1. 确保指定的URL为 http://127.0.0.1:3001/mcp （如果不使用默认值，请更换主机或端口）。

1. 点击 Connect 然后 List Tools.

1. 选择一个工具，提供参数值，然后单击 Run Tool.

许可证

版权所有（c）2026 Modulewise Inc和Modulewise可组合MCP贡献者。

Apache许可证v2.0：请参阅 许可证 了解详情。