关于 KarmaDue
KarmaDue 是面向 AI Agent 的只读安装前安全检查 MCP 服务,可检查软件包和 MCP 服务是否存在已记录的陷阱、修复方案或恶意软件报告;无证据不代表安全。
主要功能
- 01安装前检查软件包
- 02提供已测试的修复步骤和警告
- 03标记已报告的恶意软件包
- 04无需账户的只读检查
- 05附带注明日期的测试记录
适用场景
- 01安装前检查 npm 或 pip 软件包
- 02添加前审查 MCP 服务
- 03查找已知安装陷阱的修复方法
MCP 相关
向 MCP 客户端提供 check_install、search_recipes 和 report_leaf 工具。OAuth 2.1 端点还提供 search 和 fetch。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
服务地址
https://karmadue--mcp.expo.app/mcp一键复制安装命令
Claude CodeTerminal
claude mcp add --transport http ashadow07-karmadue https://karmadue--mcp.expo.app/mcpCursor.cursor/mcp.json
{"mcpServers":{"ashadow07-karmadue":{"type":"http","url":"https://karmadue--mcp.expo.app/mcp"}}}在 Cursor 中打开VS Code.vscode/mcp.json
{"servers":{"ashadow07-karmadue":{"type":"http","url":"https://karmadue--mcp.expo.app/mcp"}}}在 VS Code 中打开Claude Desktopclaude_desktop_config.json
{"mcpServers":{"ashadow07-karmadue":{"type":"http","url":"https://karmadue--mcp.expo.app/mcp"}}}Windsurf~/.codeium/windsurf/mcp_config.json
{"mcpServers":{"ashadow07-karmadue":{"serverUrl":"https://karmadue--mcp.expo.app/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
全部服务地址
Streamable HTTP
https://karmadue--mcp.expo.app/mcpStreamable HTTP
https://ogogoizwsfaduzehkshb.supabase.co/functions/v1/mcp/connectorStreamable HTTP
https://ogogoizwsfaduzehkshb.supabase.co/functions/v1/mcp工具
5| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| target | string | 是 | 要安装的包或服务,例如 tailwindcss@4、psycopg2、@modelcontextprotocol/server-filesystem。 |
| ecosystem | enum | 是 | npm | pypi | mcp |
| runtime_env | string | 否 | 可选,例如 node 20 linux。 |
详细介绍
KarmaDue
面向 AI Agent 的安装前检查。在 Agent 运行 npm install、pip install、uv add、npx/uvx 或添加 MCP 服务前,它会调用 check_install 并获得一个结果:已知陷阱及经过测试的修复步骤(fix_first)、warn、针对恶意软件包报告的 deny、no_known_issues,或 unknown(没有证据;不代表已确认安全)。
- 只读。不会执行你的命令。
- 读取无需账户或密钥。匿名限制:每个 IP 每小时 30 次请求。
- 每项修复都引用一条注明日期的测试记录。种子记录标注为 "创始人执行的评估,并非独立评估"。
- 如实说明限制:不涵盖锁文件安装(
npm ci、pip install -r)和传递依赖。
试用(无需账户)
curl -s -X POST https://ogogoizwsfaduzehkshb.supabase.co/functions/v1/mcp \
-H 'content-type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"check_install","arguments":{"target":"tailwindcss@4","ecosystem":"npm","runtime_env":"node 20 linux"}}}'
MCP 服务
| 端点(Streamable HTTP) | 身份验证 | 工具 |
|---|---|---|
https://ogogoizwsfaduzehkshb.supabase.co/functions/v1/mcp | 读取无需身份验证 | check_install、search_recipes、report_leaf |
https://ogogoizwsfaduzehkshb.supabase.co/functions/v1/mcp/connector | OAuth 2.1(Claude、ChatGPT) | 同上,另有 search、fetch |
https://karmadue--mcp.expo.app/mcp | OAuth 2.1 镜像(严格客户端) | 与 connector 相同 |
Claude Code:claude mcp add --transport http karmadue https://karmadue--mcp.expo.app/mcp
此仓库包含什么
| 路径 | 内容 |
|---|---|
guard/ | karmadue-guard:为 npm/npx/pnpm/yarn 和 pip/uv 提供安装前检查的封装程序。日志仅保存在本地,不含机密信息。安装:curl -fsSL https://karmadue.expo.app/guard/install.sh | sh |
claude-code/ | Claude Code PreToolUse 钩子(karmadue-preinstall.js,无依赖项)和 .mcp.json |
docs/ | 发布于 https://karmadue.expo.app/docs/ 的 Agent 文档(快速入门、工具、权限、安全、更新日志) |
llms.txt | https://karmadue.expo.app/llms.txt |
data/seed-records.json | 已发布的种子记录(经过测试的安装陷阱及修复),是 https://karmadue.expo.app/docs/seed-records.json 的快照 |
服务端和数据库托管在外部,不属于此仓库。
链接
- 网站:https://karmadue.expo.app
- 快速入门:https://karmadue.expo.app/docs/mcp.md
- 官方 MCP Registry 名称:
io.github.ashadow07/karmadue
许可证
MIT,详见 LICENSE。种子记录描述第三方软件包,是注明日期的观察记录,不构成保证。
评论
支持 Markdown
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。