KarmaDue について
KarmaDueは、AIエージェント向けの読み取り専用インストール前安全確認MCPサーバーです。パッケージやMCPサーバーについて、既知の問題、修正策、悪意あるパッケージの報告を確認し、情報がない状態を安全とは区別します。
主な機能
- 01インストール前のパッケージ確認
- 02テスト済み修正手順と警告の提示
- 03報告済み悪意あるパッケージの検出
- 04アカウント不要の読み取り専用確認
- 05日付付きテスト記録の掲載
活用シーン
- 01npmやpipパッケージの導入前確認
- 02MCPサーバー追加前の確認
- 03既知の導入時の問題に対する修正策探し
MCP 対応
MCPクライアントにcheck_install、search_recipes、report_leafツールを提供します。OAuth 2.1のエンドポイントではsearchとfetchも利用できます。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://karmadue--mcp.expo.app/mcpclaude mcp add --transport http ashadow07-karmadue https://karmadue--mcp.expo.app/mcp{"mcpServers":{"ashadow07-karmadue":{"type":"http","url":"https://karmadue--mcp.expo.app/mcp"}}}Cursor で開く{"servers":{"ashadow07-karmadue":{"type":"http","url":"https://karmadue--mcp.expo.app/mcp"}}}VS Code で開く{"mcpServers":{"ashadow07-karmadue":{"type":"http","url":"https://karmadue--mcp.expo.app/mcp"}}}{"mcpServers":{"ashadow07-karmadue":{"serverUrl":"https://karmadue--mcp.expo.app/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
https://karmadue--mcp.expo.app/mcphttps://ogogoizwsfaduzehkshb.supabase.co/functions/v1/mcp/connectorhttps://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 エージェント向けのインストール前チェックです。エージェントが npm install、pip install、uv add、npx/uvx を実行したり、MCP サーバーを追加したりする前に、check_install を呼び出すと、次のいずれかの結果が返ります。既知の問題とテスト済みの修正手順(fix_first)、warn、悪意のあるパッケージの報告に対する deny、no_known_issues、または unknown(証拠なし。安全性の確認を意味するものではありません)。
- 読み取り専用です。コマンドが実行されることはありません。
- 読み取りにアカウントやキーは不要です。匿名での利用上限は、IP アドレスごとに 1 時間あたり 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/ で公開されているエージェント向けドキュメント(クイックスタート、ツール、権限、セキュリティ、変更履歴) |
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 を参照してください。初期レコードはサードパーティ製パッケージについて記述した日付入りの観察記録であり、保証ではありません。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。