Inkog

io.github.inkog-io由 GitHub 账号 inkog-io 发布v1.0.20更新于 Oct 24, 2026

Security co-pilot for AI agents. Scan for vulnerabilities, audit MCP servers, verify governance.

概览

AI 生成的概览

Inkog 是一个本地运行的安全副驾驶 MCP 服务器,让助手扫描 AI 智能体代码漏洞、核验治理声明并审计 MCP 服务器。

可以做什么
扫描智能体代码和目录,发现逻辑缺陷与安全风险,可选分析策略和包括 SARIF 在内的输出格式。核验 AGENTS.md 治理声明与实际代码行为是否一致。生成面向 EU AI Act、NIST AI RMF、ISO 42001 和 OWASP LLM Top 10 的合规报告。解释发现的问题并给出修复建议。审计注册表或 GitHub 仓库中的 MCP 服务器,并审计多智能体系统中的智能体间委派。生成 CycloneDX、SPDX 或 JSON 格式的机器学习物料清单。
适用场景
适合在 Claude、Cursor 等客户端中开发或审查 AI 智能体代码时使用,希望在同一对话内获得安全发现和修复建议。也适合发布前的治理核验、合规报告,以及在采用前审查 MCP 服务器或多智能体交接。
运行要求
通过 npx 或全局 npm 安装后在本地运行,需要 Node.js。需要 Inkog 账号和 API 密钥,通过环境变量 INKOG_API_KEY 提供,说明中提到有免费套餐。需要访问 Inkog API 的网络,可选配置 INKOG_API_URL、INKOG_API_VERSION、INKOG_API_TIMEOUT、INKOG_LOG_LEVEL 和 INKOG_LOG_FORMAT。
安装前请注意
INKOG_API_KEY 中的 API 密钥属于机密,不应分享或提交到代码库。被扫描的代码和路径会发送到 Inkog API 进行分析,不要指向内容不能离开本机的仓库。README 还提到 GitHub Actions 集成,会为拉取请求添加自动化安全检查。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Inkog,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Inkog MCP Server

Security companion for AI agent development in Claude, Cursor, and Claude Code.

Ask your AI pair-programmer to build an agent. Inkog checks it as you code — scanning for vulnerabilities, explaining findings in plain English, verifying AGENTS.md governance, and auditing agent-to-agent delegation. All inside the same conversation, no context switch.

Available in Claude Desktop, Cursor, Claude Code, ChatGPT, and any MCP-compatible client.

[npm version] [License] [MCP Compatible]

The Dev-Flow Loop

Inkog is designed to live inside the conversation where you build the agent — not as a post-hoc gate:

  1. Ask Claude to build a piece of agent logic.
  2. Ask Claude to scan it with Inkog — "Scan this with Inkog and show me any CRITICAL or HIGH findings."
  3. Ask Claude to explain each finding in plain English — "Explain the top finding. What's the risk, and how do I fix it?"
  4. Ask Claude to apply the fixes. Review the diff, approve, re-scan.
  5. Before shipping, verify governance — "Verify my AGENTS.md against the code" and "Audit the agent-to-agent delegation".

Read the full walkthrough: Building Secure AI Agents with Claude Code and the Inkog MCP.

Recommended prompts

  • "Scan the current directory with Inkog and show me any CRITICAL or HIGH findings."
  • "Explain the top finding in plain English. What's the risk, and how do I fix it?"
  • "Verify my AGENTS.md against the code."
  • "Audit the agent-to-agent delegation in this crew."
  • "Run a compliance report and map the findings to EU AI Act Articles 12, 14, and 15."
  • "Audit the MCP servers I'm integrating with."

When to Use Inkog

  • Building an AI agent — Scan during development to catch infinite loops, prompt injection, and missing guardrails before they ship
  • Adding security to CI/CD — Add inkog-io/inkog@v1 to GitHub Actions for automated security gates on every PR
  • Preparing for EU AI Act — Generate compliance reports mapping your agent to Article 14, NIST AI RMF, OWASP LLM Top 10
  • Reviewing agent code — Use from Claude Code, Cursor, or any MCP client to get security analysis while you code
  • Auditing MCP servers — Check any MCP server for tool poisoning, privilege escalation, or data exfiltration before installing
  • Verifying AGENTS.md — Validate that governance declarations match actual code behavior
  • Building multi-agent systems — Detect delegation loops, privilege escalation, and unauthorized handoffs between agents

What Inkog Does

  • Logic Flaw Detection: Find infinite loops, recursion risks, and missing exit conditions
  • Security Analysis: Detect prompt injection paths, unconstrained tools, and data leakage risks
  • AGENTS.md Governance: Validate that code behavior matches governance declarations
  • Compliance Reporting: Generate reports for EU AI Act, NIST AI RMF, OWASP LLM Top 10
  • MCP Server Auditing: Audit any MCP server before installation
  • Multi-Agent Analysis: Audit Agent-to-Agent communications for logic and security issues

Installation

Claude Desktop

Add to your claude_desktop_config.json:

json
{  "mcpServers": {    "inkog": {      "command": "npx",      "args": ["-y", "@inkog-io/mcp"],      "env": {        "INKOG_API_KEY": "sk_live_your_api_key"      }    }  }}

Cursor

Add to your Cursor MCP settings:

json
{  "mcpServers": {    "inkog": {      "command": "npx",      "args": ["-y", "@inkog-io/mcp"],      "env": {        "INKOG_API_KEY": "sk_live_your_api_key"      }    }  }}

Global Installation

bash
npm install -g @inkog-io/mcp

Getting Your API Key

  1. Sign up for free at app.inkog.io
  2. Copy your API key from the dashboard
  3. Set it as INKOG_API_KEY environment variable

Available Tools

P0 - Core Analysis (Essential)

ToolDescription
inkog_scanStatic analysis for logic flaws and security risks
inkog_verify_governanceValidate AGENTS.md declarations match actual code behavior

P1 - Enterprise Features

ToolDescription
inkog_compliance_reportGenerate EU AI Act, NIST, OWASP compliance reports
inkog_explain_findingGet detailed remediation guidance for findings
inkog_audit_mcp_serverAudit any MCP server before installation
inkog_generate_mlbomGenerate ML Bill of Materials (CycloneDX, SPDX)

P2 - Multi-Agent Analysis

ToolDescription
inkog_audit_a2aAudit Agent-to-Agent communications

Tool Details

inkog_scan

Static analysis for AI agent code - finds logic flaws and security risks.

Arguments:  path     (required) File or directory path to scan  policy   (optional) Analysis policy: low-noise, balanced, comprehensive, governance, eu-ai-act  output   (optional) Output format: summary, detailed, sarif

Example: "Scan my LangChain agent for logic flaws"

inkog_verify_governance

Validate that AGENTS.md declarations match actual code behavior. This is Inkog's unique differentiator - no other tool does governance verification.

Arguments:  path     (required) Path to directory containing AGENTS.md and agent code

Example: "Verify my agent's governance declarations"

inkog_compliance_report

Generate compliance reports for regulatory frameworks.

Arguments:  path      (required) Path to scan  framework (optional) eu-ai-act, nist-ai-rmf, iso-42001, owasp-llm-top-10, all  format    (optional) markdown, json, pdf

Example: "Generate an EU AI Act compliance report for my agent"

inkog_explain_finding

Get detailed explanation and remediation guidance for a security finding.

Arguments:  finding_id (optional) Finding ID from scan results  pattern    (optional) Pattern name (e.g., prompt-injection, infinite-loop)

Example: "Explain how to fix prompt injection vulnerabilities"

inkog_audit_mcp_server

Security audit any MCP server from the registry or GitHub.

Arguments:  server_name    (optional) MCP server name from registry (e.g., "github", "slack")  repository_url (optional) Direct GitHub repository URL

Example: "Audit the GitHub MCP server for security issues"

inkog_generate_mlbom

Generate a Machine Learning Bill of Materials listing all AI components.

Arguments:  path                     (required) Path to agent codebase  format                   (optional) cyclonedx, spdx, json  include_vulnerabilities  (optional) Include known CVEs (default: true)

Example: "Generate an MLBOM for my AI project"

inkog_audit_a2a

Audit Agent-to-Agent communications for security risks.

Arguments:  path                    (required) Path to multi-agent codebase  protocol                (optional) a2a, crewai, langgraph, auto-detect  check_delegation_chains (optional) Check for infinite loops (default: true)

Example: "Audit my CrewAI multi-agent system for security risks"

Supported Frameworks

Inkog works with all major AI agent frameworks:

  • LangChain / LangGraph
  • CrewAI
  • AutoGen
  • n8n
  • Flowise
  • Dify
  • Microsoft Copilot Studio
  • Custom implementations

Configuration

All configuration is done via environment variables:

VariableDescriptionDefault
INKOG_API_KEYYour API key (required)-
INKOG_API_URLAPI base URLhttps://api.inkog.io
INKOG_API_VERSIONAPI versionv1
INKOG_API_TIMEOUTRequest timeout (ms)30000
INKOG_LOG_LEVELLog levelinfo
INKOG_LOG_FORMATLog format (json/text)json

Development

bash
# Install dependenciesnpm install
# Buildnpm run build
# Run in development modenpm run dev
# Run testsnpm test
# Lintnpm run lint

Why Inkog?

Security in the Dev-Flow, Not After It

Most AI agent security tools run after the code is written. Inkog lives inside the conversation where you build the agent — so findings get fixed before they land in a PR, not three weeks later.

The Only Tool with AGENTS.md Verification

Inkog is the only tool that can validate your agent's governance declarations against its actual code behavior. This is essential for:

  • EU AI Act Article 14 compliance (human oversight)
  • Enterprise governance requirements
  • Preventing governance drift as code evolves

Purpose-Built for AI Agents

Unlike traditional code scanners (Snyk, Semgrep, SonarQube), Inkog understands AI-specific issues:

  • Infinite loops and recursion risks
  • Prompt injection paths
  • Unconstrained tool access
  • Missing exit conditions
  • Cross-tenant data leakage

Multi-Framework Support

Inkog's Universal IR (Intermediate Representation) works with any agent framework. Add one integration, get analysis for all frameworks.

License

Apache-2.0 - see LICENSE

Links


Built with security by Inkog.io

来源:README.md,提交 88ab34e

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v1.0.20最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分