mcpField
A
agentskin

agentskin

ローカル
github.com/Shawn5centsAI・エージェント14 週間前に更新
リポジトリ

agentskin について

AgentSkinは、AIエージェント向けのコンテキストミドルウェアです。API、JSON、ターミナル、テキストの低価値な出力をモデルのコンテキストに入る前に整理し、入力の自動判別やURL別ルール、公開URL取得時の保護機能を備えています。

主な機能

  1. 01JSON、コマンドライン出力、テキストの自動判別
  2. 02URLルールによる構造化APIデータの整理
  3. 03公開URLの取得と最適化
  4. 04ターミナル出力の圧縮
  5. 05トークン推定と診断ツール
  6. 06SSRFチェックとリクエスト制限

活用シーン

  1. 01モデル処理前の冗長なAPIデータの削減
  2. 02エージェント向けターミナル出力の圧縮
  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 エージェント向けのコンテキストミドルウェアです。 AgentSkin は、価値の低い API、JSON、ターミナルのノイズがモデルのコンテキストに入る前に取り除きます。

凍結された AgentSkin 5.1 オフラインコア評価には、受け入れ済みの Sparse Env 実行パスもあります。AgentSkin はワークロードの正確性に関する契約を維持し、Sparse Env がコールド／ウォーム環境の選択とライフサイクルを担います。詳しくは agentskin/docs/SPARSE_ENV.md を参照してください。

機能

AgentSkin には、主に3つのワークフローがあります。

  • compress — JSON、CLI 出力、プレーンテキストを自動検出する統合窓口です。
  • fetch_optimized_data — 公開 URL からデータを取得し、利用可能な場合は URL 固有の枝刈りルールを適用します。
  • reduce — Tokenjuice のルール駆動型リデューサーを使用して、ターミナル出力を圧縮します。

互換性と診断のため、5つの高度なツールも引き続き利用できます：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 などの汎用キーは、明示的なルールがない場合に限り、フォールバックシグナルとして使用します。

タスクに必要な情報が保持される場合にのみ、削減は有効です。

現在の検証状況

リリースゲートでは、MCP の起動／セキュリティテストや実際の HTTP 統合テストを含む、AgentSkin が管理するテストスイートを実行します。次のコマンドで実行できます。

cd agentskin
npm ci
npm test

ベンチマークはワークロードごとに異なります。テストスイートは、汎用的な削減率を謳うのではなく、フィクスチャーで測定された削減量を出力します。

ランタイム

  • stdio 経由の Node.js MCP サーバー
  • CLI 出力の削減には、通常の npm 依存関係として Tokenjuice を使用
  • 構造化 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 の削減には、MIT ライセンスに基づく Vincent Koc 作の Tokenjuice を使用しています。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。