io.github.inkog-io/inkog
编码与调试by inkog-io
Security co-pilot for AI agents. Scan for vulnerabilities, audit MCP servers, verify governance.
什么是 io.github.inkog-io/inkog?
Security co-pilot for AI agents. Scan for vulnerabilities, audit MCP servers, verify governance.
README
Inkog MCP Server
Build secure AI agents from the start. Inkog is the security co-pilot for AI agent development — scan for vulnerabilities, verify AGENTS.md governance, audit MCP servers before installation, and map to EU AI Act compliance. Available in Claude, ChatGPT, Cursor, and any MCP-compatible client.
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@v1to 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:
{
"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:
{
"mcpServers": {
"inkog": {
"command": "npx",
"args": ["-y", "@inkog-io/mcp"],
"env": {
"INKOG_API_KEY": "sk_live_your_api_key"
}
}
}
}
Global Installation
npm install -g @inkog-io/mcp
Getting Your API Key
- Sign up for free at app.inkog.io
- Copy your API key from the dashboard
- Set it as
INKOG_API_KEYenvironment variable
Available Tools
P0 - Core Analysis (Essential)
| Tool | Description |
|---|---|
inkog_scan | Static analysis for logic flaws and security risks |
inkog_verify_governance | Validate AGENTS.md declarations match actual code behavior |
P1 - Enterprise Features
| Tool | Description |
|---|---|
inkog_compliance_report | Generate EU AI Act, NIST, OWASP compliance reports |
inkog_explain_finding | Get detailed remediation guidance for findings |
inkog_audit_mcp_server | Audit any MCP server before installation |
inkog_generate_mlbom | Generate ML Bill of Materials (CycloneDX, SPDX) |
P2 - Multi-Agent Analysis
| Tool | Description |
|---|---|
inkog_audit_a2a | Audit 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:
| Variable | Description | Default |
|---|---|---|
INKOG_API_KEY | Your API key (required) | - |
INKOG_API_URL | API base URL | https://api.inkog.io |
INKOG_API_VERSION | API version | v1 |
INKOG_API_TIMEOUT | Request timeout (ms) | 30000 |
INKOG_LOG_LEVEL | Log level | info |
INKOG_LOG_FORMAT | Log format (json/text) | json |
Development
# Install dependencies
npm install
# Build
npm run build
# Run in development mode
npm run dev
# Run tests
npm test
# Lint
npm run lint
Why Inkog?
The Pre-Flight Check for AI Agents
Think of Inkog like the checklist pilots run before takeoff. You don't skip it even when you're confident. It verifies your agent is ready to ship.
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
常见问题
io.github.inkog-io/inkog 是什么?
Security co-pilot for AI agents. Scan for vulnerabilities, audit MCP servers, verify governance.
相关 Skills
网页构建器
by anthropics
面向复杂 claude.ai HTML artifact 开发,快速初始化 React + Tailwind CSS + shadcn/ui 项目并打包为单文件 HTML,适合需要状态管理、路由或多组件交互的页面。
✎ 在 claude.ai 里做复杂网页 Artifact 很省心,多组件、状态和路由都能顺手搭起来,React、Tailwind 与 shadcn/ui 组合效率高、成品也更精致。
前端设计
by anthropics
面向组件、页面、海报和 Web 应用开发,按鲜明视觉方向生成可直接落地的前端代码与高质感 UI,适合做 landing page、Dashboard 或美化现有界面,避开千篇一律的 AI 审美。
✎ 想把页面做得既能上线又有设计感,就用前端设计:组件到整站都能产出,难得的是能避开千篇一律的 AI 味。
网页应用测试
by anthropics
用 Playwright 为本地 Web 应用编写自动化测试,支持启动开发服务器、校验前端交互、排查 UI 异常、抓取截图与浏览器日志,适合调试动态页面和回归验证。
✎ 借助 Playwright 一站式验证本地 Web 应用前端功能,调 UI 时还能同步查看日志和截图,定位问题更快。
相关 MCP Server
GitHub
编辑精选by GitHub
GitHub 是 MCP 官方参考服务器,让 Claude 直接读写你的代码仓库和 Issues。
✎ 这个参考服务器解决了开发者想让 AI 安全访问 GitHub 数据的问题,适合需要自动化代码审查或 Issue 管理的团队。但注意它只是参考实现,生产环境得自己加固安全。
Context7 文档查询
编辑精选by Context7
Context7 是实时拉取最新文档和代码示例的智能助手,让你告别过时资料。
✎ 它能解决开发者查找文档时信息滞后的问题,特别适合快速上手新库或跟进更新。不过,依赖外部源可能导致偶尔的数据延迟,建议结合官方文档使用。
by tldraw
tldraw 是让 AI 助手直接在无限画布上绘图和协作的 MCP 服务器。
✎ 这解决了 AI 只能输出文本、无法视觉化协作的痛点——想象让 Claude 帮你画流程图或白板讨论。最适合需要快速原型设计或头脑风暴的开发者。不过,目前它只是个基础连接器,你得自己搭建画布应用才能发挥全部潜力。