@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