mcp-devtools

Model Context Protocol を介したAIネイティブな開発者ツール。 AIエージェント（Claude、Cursor、Copilot、Continueなど）に、ローカル開発環境への安全でスコープ制限されたアクセスを提供する本番環境グレードのMCPサーバーです。

なぜこれが必要か

MCPエコシステムは、単一目的のチュートリアルやベンダーロックインされたアダプターで溢れています。日常的な開発ツールとして、十分にメンテナンスされ、マルチツールに対応し、フレームワークに依存しない、本番品質のMCPパッケージは存在しませんでした。

mcp-devtools は、14個のツール、3個のMCPリソース、4個のMCPプロンプト、プラグインAPI、2つのトランスポートモード（stdio + 認証付きHTTP）、そしてDailyBotの本番環境で洗練されたパターンに基づいて構築された監査ログを備え、そのギャップを埋めます。

Related MCP server: GPT Commander

クイックスタート

stdio (デフォルト)

npx @oscarmarin/mcp-devtools

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json) に追加します：

{
  "mcpServers": {
    "devtools": {
      "command": "npx",
      "args": ["-y", "@oscarmarin/mcp-devtools"]
    }
  }
}

または Cursor (~/.cursor/mcp.json)：同じブロックを追加します。

HTTPトランスポート

プロジェクトのルートに mcp-devtools.json を作成します：

{
  "transport": "http",
  "port": 3333,
  "auth": {
    "token": "env:MCP_AUTH_TOKEN"
  }
}

次にサーバーを起動します：

npx @oscarmarin/mcp-devtools

MCPエンドポイントは http://localhost:3333 で利用可能になります。

ツール

ツールごとのリファレンス: docs/tools/。

MCPリソース

このサーバーは、MCPリソースを介して読み取り専用データを公開します：

MCPプロンプト

一般的な開発ワークフロー向けに厳選されたプロンプトテンプレート：

プラグインAPI

mcp-devtools をカスタムツールで拡張できます（フォークは不要です）。

設定ベース（起動時に読み込み）：

{
  "plugins": ["./my-tools.js", "@scope/mcp-plugin-foo"]
}

各プラグインモジュールは、ツール定義の配列をデフォルトエクスポートします：

import { defineTool } from "@oscarmarin/mcp-devtools";
import { z } from "zod";

export default [
  defineTool({
    name: "my_tool",
    description: "Does something useful",
    inputSchema: z.object({ input: z.string() }),
    handler: async (args, config) => ({
      ok: true,
      data: { result: args.input.toUpperCase() },
    }),
  }),
];

設定

設定は cosmiconfig によって mcp-devtools.json、.mcp-devtoolsrc、または package.json 内の mcpDevtools キーから読み込まれます。完全なスキーマについては mcp-devtools.example.json および docs/configuration.md を参照してください。

ゼロコンフィグもサポートされています：設定なしで npx @oscarmarin/mcp-devtools を実行すると、スキーマのデフォルト値（RNF-05）が使用されます。

セキュリティ

4つの回避不可能な制御：

1. ファイルシステムのスコープ境界。 すべてのパスは絶対パスに解決され、config.scope と比較されます。スコープ外へ脱出するシンボリックリンクは SCOPE_VIOLATION をスローします。

2. コマンド許可リスト。 run_command は、ベース名が allowedCommands に含まれるバイナリのみを実行します。呼び出しには spawn(file, args)（シェルなし）を使用するため、コマンド引数を介したシェルインジェクションは構造的に不可能です。

3. データベースの読み取り専用モード。 readOnly: true の場合、すべてのSQLが解析され、INSERT/UPDATE/DELETE/DROP/CREATE/GRANT は拒否されます。クエリはPostgreSQL上で BEGIN READ ONLY ... ROLLBACK として実行されます。

4. HTTP Bearer認証。 auth.token が設定されている場合、すべてのHTTPリクエストには Authorization: Bearer <token> を含める必要があります。比較には crypto.timingSafeEqual を使用し、タイミング攻撃を防ぎます。

その他の安全対策：

• 監査ログ。 すべてのツール呼び出しについて、タイミング、サニタイズされた入力、結果ステータスを含むNDJSONログをオプトインで記録できます。

• シークレットのマスキング。 get_env は、一般的なシークレットパターン（SECRET, TOKEN, PASSWORD, KEY など）に一致する値を自動的にマスクします。

• OpenAPIホスト制限。 call_api は、仕様の servers 配列にリストされているホストへのリクエストのみを送信します。

• 出力制限。 すべてのツールは、コンテキストの溢れを防ぐために出力を制限します（コマンドは100KB、ファイルは1MB、クエリは200行まで）。

貢献

git clone https://github.com/marin1321/mcp-devtools.git
cd mcp-devtools
npm install
npm run dev       # tsup --watch
npm run test      # vitest
npm run typecheck # tsc --noEmit
npm run lint      # eslint .

完全なワークフローについては CONTRIBUTING.md を、コミュニティガイドラインについては CODE_OF_CONDUCT.md を参照してください。

ライセンス

MIT © Oscar Humberto Marin Molina — oscarmarindev.com