mcpField
A
agentskin

agentskin

本地服务
github.com/Shawn5centsAI 与智能体14 周前更新
代码仓库

关于 agentskin

AgentSkin 是面向 AI Agent 的上下文中间件，可在内容进入模型上下文前精简低价值的 API、JSON、终端和文本输出。它会自动识别输入类型，并支持 URL 专属规则及公开 URL 抓取防护。

主要功能

  1. 01自动识别 JSON、命令行输出或文本
  2. 02按 URL 规则精简结构化 API 数据
  3. 03抓取并优化公开 URL
  4. 04精简终端输出
  5. 05令牌估算与诊断工具
  6. 06SSRF 检查和请求限制

适用场景

  1. 01在模型处理前精简冗余 API 数据
  2. 02压缩供 Agent 使用的终端输出
  3. 03抓取并按语义规则精简公开 URL

MCP 相关

AgentSkin 是通过 stdio 运行的 Node.js MCP 服务，提供内容压缩、抓取和精简工具，以及兼容性和诊断工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "shawn5cents-agentskin": {
      "command": "npx",
      "args": [
        "-y",
        "agentskin"
      ],
      "env": {
        "BRAVE_SEARCH_API_KEY": "<BRAVE_SEARCH_API_KEY>",
        "SERPER_API_KEY": "<SERPER_API_KEY>",
        "TAVILY_API_KEY": "<TAVILY_API_KEY>",
        "APILAYER_KEY": "<APILAYER_KEY>"
      }
    }
  }
}
启动命令npx -y agentskin
需要配置的环境变量
BRAVE_SEARCH_API_KEY密钥Brave Search API Key
SERPER_API_KEY密钥Serper.dev Search API Key
TAVILY_API_KEY密钥Tavily Search API Key
APILAYER_KEY密钥MediaStack API Key

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmagentskin4.0.1

工具

2

收录的工具列表 · 更新于 3 周前

参数类型必填说明
urlstring是要获取的原始 API 或 JSON URL。
headersobject否可选：用于访问私有数据的自定义 HTTP 标头（例如 {'API-Key': 'your_key'}）。
signalsarray否可选：要查找的特定键（例如 ['price', 'status']）。

详细介绍

AgentSkin

npm version License: MIT

面向 AI Agent 的上下文中间件。 AgentSkin 会在低价值的 API、JSON 和终端噪声进入模型上下文前将其移除。

冻结的 AgentSkin 5.1 离线核心评估也包含已获接受的 Sparse Env 执行路径。AgentSkin 保留工作负载正确性约定，同时由 Sparse Env 负责冷启动／热启动环境的选择和生命周期；详情参见 agentskin/docs/SPARSE_ENV.md。

功能

AgentSkin 有三种主要工作流：

  • compress — 统一入口，自动检测 JSON、CLI 输出或纯文本。
  • fetch_optimized_data — 获取公共 URL，并在有可用规则时应用针对该 URL 的裁剪规则。
  • reduce — 使用 Tokenjuice 的规则驱动型精简器压缩终端输出。

另有五种高级工具保留用于兼容性和诊断：apply_json_semantic、classify_url、strip_ansi、estimate_tokens 和 skin_reasoning。

快速开始

npx -y agentskin@latest

MCP 配置：

{
  "mcpServers": {
    "agentskin": {
      "command": "npx",
      "args": ["-y", "agentskin@latest"]
    }
  }
}

设计原则

保真优先，其次压缩。 显式信号和 URL 规则具有权威性。仅当不存在显式规则时，id、name 和 url 等通用键才会作为备用信号。

只有任务所需的信息在精简后得以保留，这种精简才有意义。

当前验证

发布门禁会运行由 AgentSkin 维护的测试套件，包括 MCP 启动／安全性和实时 HTTP 集成测试。运行命令：

cd agentskin
npm ci
npm test

基准测试针对特定工作负载。测试套件会输出其测试样例测得的精简比例，而不会宣称一个普遍适用的节省百分比。

运行时

  • 通过 stdio 运行的 Node.js MCP 服务
  • Tokenjuice 是 CLI 精简功能所需的常规 npm 依赖项
  • 面向结构化 API 的 URL 专属语义裁剪规则
  • 针对获取请求的 SSRF 检查、响应大小限制、速率限制、Zod 验证和处理超时

开发

npm 软件包位于此仓库中的 agentskin/ 目录。

cd agentskin
npm ci
npm test
npm run lint
npm pack --dry-run

致谢

AgentSkin 语义裁剪和 MCP 集成：Shawn Nichols Sr. / Nichols Transco LLC。

CLI 精简功能使用 Vincent Koc 按 MIT 许可证发布的 Tokenjuice。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。