@defarm/mcp

DeFarm 用の MCP サーバー — AI エージェントが、コード不要で説明によって検証可能な農業トレーサビリティデータを 封印、開封、検証、取り込み できるようにします。@defarm/sdk 上に構築: 封印されたフィールドはクライアント側で暗号化され、DeFarm サーバーはそれらに対して 構造的にブラインド です。

SDK と同じ理由でオープンソース (MIT): DeFarm を信頼せず、クライアントを監査してください。

セキュリティ体制 (最初に読むべき部分)

• 認証情報がモデルを経由することはありません。 認証はサーバー設定 (下記の環境変数) です。ログインツールはなく、パスワード、API キー、鍵素材を受け入れるツールもありません — テストスイートがそれを強制します。

• 秘密鍵がローカルキーストアから出ることはありません。 秘密素材を返すツールはなく、エージェントは ID とフィンガープリントのみを参照します。

• 安全なデフォルトは SDK から継承されます: 封印は明示的に宛先を指定しない限りプライベートかつ自己宛てです。暗号スイートは固定されており、選択肢はありません。

Related MCP server: Wallet4Agent MCP Server

セットアップ

// e.g. Claude Desktop / Claude Code MCP config
{
  "mcpServers": {
    "defarm": {
      "command": "npx",
      "args": ["-y", "github:defarm-repo/defarm-mcp"],
      "env": {
        "DEFARM_GATEWAY": "<your test-environment gateway>",
        "DEFARM_EMAIL": "<workspace login>",
        "DEFARM_PASSWORD": "<workspace password>",
        "DEFARM_API_KEY": "<partner key, only if the agent should ingest>",
        "DEFARM_KEYSTORE": "~/.defarm/keys.json"
      }
    }
  }
}

まず DEFARM_GATEWAY を テスト環境 に向けてください。本番環境は明示的な決定です。

ツール

バックエンドでブロックされている操作 (grant、grantLink、revoke — engines#584/#574) はツールとして公開されません。エージェントが常に失敗するツールを見るべきではないからです。

開発

依存関係: npm から semver (^0.2.0) で @defarm/sdk — SHA ピン時代 (および「ピンは最新の SDK スクワッシュに従う」ルール) は、約束どおり 0.2.0 の公開で終了しました。

npm install
npm test        # tool-table contract tests (no network, fake gateway)
npm run build && DEFARM_GATEWAY=... node dist/index.js   # stdio server

ライセンス

MIT