@alfe.ai/mcp-tools

中文文档
0.6.0发布于 2026/11/05UNLICENSEDTypeScriptESM + CJS近 30 天下载 1916

Shared MCP tool implementations for Alfe's local CLI-bundled MCP server and (later) the Fly-deployed services/mcp. All tools use AgentApiClient against public /agent/... endpoints — never InternalClient.

原始使用文档

@alfe.ai/mcp-tools

Shared MCP tool implementations for Alfe's local CLI-bundled MCP server. All Alfe API calls use AgentApiClient against public agent endpoints — never InternalClient or raw authenticated fetch.

The package exports registrars for integrations, wallet, memory, one-shot voice, outbound SMS, web/image/news search, read-only secrets (decrypted on the agent with KMS-unwrapped data keys), shared knowledge resources, and webhook management. The server chooses which registrars to expose for each runtime profile.

Agent-scoped tools never take an agent or tenant id from the model: the identity is the server's whoami() result. Secret tools reject a scopeId for agent scope, and webhook tools act only on the calling agent's webhooks.

Model-controlled file arguments are workspace-relative and realpath-contained. Memory and audio inputs are size-bounded; voice output creates a new file and never overwrites an existing path. Tool schemas mirror the downstream public API's string, enum, and numeric limits.

Part of Alfe — the operating system for AI agents: build, deploy, and run agents with persistent memory, identity, integrations, and channels. See the documentation to get started.

Install

npm install @alfe.ai/mcp-tools

See DEVELOPING.md for the tool and filesystem contracts.

版本与发布记录

@alfe.ai/mcp-tools 共发布 45 个版本,首次发布于 2026/05/18;过去 12 个月发布了 45 个版本。

版本发布日期距今
0.6.0latest2026/11/053 天前
0.5.02026/10/2910 天前
0.4.12026/10/2811 天前
0.4.02026/10/2811 天前
0.3.82026/10/2217 天前
0.3.72026/10/2217 天前

关于 @alfe.ai/mcp-tools 的常见问题

@alfe.ai/mcp-tools 是什么?

Shared MCP tool implementations for Alfe's local CLI-bundled MCP server and (later) the Fly-deployed services/mcp. All tools use AgentApiClient against public /agent/... endpoints — never InternalClient.

如何安装 @alfe.ai/mcp-tools?

在项目目录运行 npm install @alfe.ai/mcp-tools,或使用 pnpm add / yarn add / bun add。

@alfe.ai/mcp-tools 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@alfe.ai/mcp-tools 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@alfe.ai/mcp-tools 可以商用吗?

@alfe.ai/mcp-tools 使用 UNLICENSED 许可。作者声明为 UNLICENSED,即不授予公开使用许可(与公共领域的 Unlicense 不同)。使用前需获得作者授权。以上为概括,不构成法律意见,请以许可原文为准。

@alfe.ai/mcp-tools 的下载量有多少?

根据 npm 官方下载统计,@alfe.ai/mcp-tools 在 2026/10/06 – 2026/11/04 这 30 天内被下载 1,916 次,日均约 64 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@alfe.ai/mcp-tools 还在维护吗?

最新版本 0.6.0 发布于 2026/11/05(3 天前);至今共发布 45 个版本,其中过去 12 个月发布了 45 个;首次发布于 2026/05/18。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。