Capture Screen MCP server

CaptureScreenMCP

<!-- mcp-name: io.github.ochtum/capture-screen -->

Windows 向けのローカル実行型 MCP サーバーです（stdio transport）。 C# / .NET 10 の .NET tool として NuGet.org に公開しており、画面キャプチャとキャプチャ画像削除ツールを提供します。

• NuGet: CaptureScreenMcp
• MCP Registry name: io.github.ochtum/capture-screen
• NuGet package ID: CaptureScreenMcp
• Tool command: capture-screen-mcp

何ができるか

• 接続ディスプレイ情報の取得
• デスクトップ全体、指定ディスプレイ、指定領域、アクティブウィンドウの PNG キャプチャ
• 出力先ディレクトリ内のキャプチャ画像一括削除
• 日付/日時範囲でのキャプチャ画像削除
• capturescreen / capturedisplay / capture_region 実行時に、撮影領域に重なった Windows Terminal を一時的に非表示化（既定で有効）

利用可能な Tools

• list_displays()
• capture_screen(outputPath?: string)
• capture_display(display?: int | string, outputPath?: string)
• capture_region(x: int, y: int, width: int, height: int, outputPath?: string)
• captureactivewindow(outputPath?: string)
• deleteallcapture_images()
• deletecaptureimagesbydatetime(targetDate?: string, startDatetime?: string, endDatetime?: string)

必要環境

• Windows
• .NET 10 SDK
• NuGet から MCP サーバーとして起動する場合は dnx を使用します。
• 開発中にソースから起動する場合は dotnet run を使用します。

環境変数

• CAPTURESCREENDEFAULT_DISPLAY
• capture_display で display 省略時の既定値
• 例: primary, left, right, プライマリ, 左, 右, 2
• CAPTURESCREENOUTPUT_DIR
• 保存先ディレクトリ（既定: C:\capture_screen）
• CAPTURESCREENHIDEFOREGROUNDWINDOWS_TERMINAL
• 1/true/on で有効、0/false/off で無効
• 既定は有効

NuGet から利用する

NuGet.org の公開済みパッケージを MCP クライアントから起動する場合は、dnx で CaptureScreenMcp を実行します。

{
  "servers": {
    "capture-screen": {
      "type": "stdio",
      "command": "dnx",
      "args": ["CaptureScreenMcp@1.0.5", "--yes"],
      "env": {
        "CAPTURE_SCREEN_OUTPUT_DIR": "C:\\capture_screen",
        "CAPTURE_SCREEN_DEFAULT_DISPLAY": "primary",
        "CAPTURE_SCREEN_HIDE_FOREGROUND_WINDOWS_TERMINAL": "1"
      }
    }
  }
}

通常の .NET tool としてインストールして起動することもできます。

dotnet tool install --global CaptureScreenMcp --version 1.0.5
capture-screen-mcp

ソースから開発実行する

ビルド

dotnet restore
dotnet build

MCP サーバー起動（stdio）

dotnet run --project src

開発中にソースツリーを直接参照する場合の接続設定例です。

{
  "servers": {
    "capture-screen": {
      "type": "stdio",
      "command": "dotnet",
      "args": ["run", "--project", "src"],
      "env": {
        "CAPTURE_SCREEN_OUTPUT_DIR": "C:\\capture_screen",
        "CAPTURE_SCREEN_DEFAULT_DISPLAY": "primary",
        "CAPTURE_SCREEN_HIDE_FOREGROUND_WINDOWS_TERMINAL": "1"
      }
    }
  }
}

公開手順

NuGet.org へ公開する

1. src/CaptureScreenMcp.csproj の を更新します。
2. .mcp/server.json のトップレベル version と packages[0].version を同じバージョンに更新します。
3. dotnet pack src/CaptureScreenMcp.csproj -c Release
4. dotnet nuget push src/bin/Release/*.nupkg --api-key --source https://api.nuget.org/v3/index.json

このパッケージは NuGet MCP サーバーとして認識されるため、以下を含めています。

• .mcp/server.json
• README.md の <!-- mcp-name: io.github.ochtum/capture-screen --> コメント
• PackageIcon に指定した icon.png
• McpServer package type
• .NET tool 設定（PackAsTool / ToolCommandName）

MCP Registry へ公開する

NuGet.org への公開だけでは、registry.modelcontextprotocol.io には自動掲載されません。 NuGet.org のパッケージ検証が完了してから、MCP Publisher で .mcp/server.json を公開します。

mcp-publisher login github
mcp-publisher publish .mcp/server.json

server.json の name と、NuGet パッケージに含まれる README.md の mcp-name は一致している必要があります。 また、packages[0].version は mcp-name が一致する NuGet パッケージのバージョンを指している必要があります。

権限と注意点

Shortened. The full README is on GitHub.