Active Context MCP

Description

A VS Code extension for telling MCP-compatible AI tools where you are looking in your code — which file, cursor position, and selection.

Setup

Install the VS Code extension first. Then add the MCP command to your MCP-compatible AI tool.

For tools that use an mcpServers config format, add this entry:

{
  "mcpServers": {
    "active_context": {
      "command": "npx",
      "args": ["-y", "active-context-mcp"]
    }
  }
}

Some tools store this in a global MCP config file, some store it in a per-project config, and some expose it through a settings UI. The important values are:

command: npx
args: -y active-context-mcp

MCP Tool

The MCP command exposes one tool:

get

It returns the current VS Code active editor context:

{
  "schema": "active-context-mcp/v1",
  "workspace": "/path/to/workspace",
  "file": "/path/to/workspace/src/example.ts",
  "relativeFile": "src/example.ts",
  "cursor": {
    "line": 10,
    "character": 5
  },
  "activeLineText": "const value = example();",
  "selection": {
    "startLine": 10,
    "startCharacter": 5,
    "endLine": 10,
    "endCharacter": 5
  },
  "updatedAt": "2026-07-07T10:00:00.000Z"
}

How It Works

The VS Code extension writes the current editor state (file, cursor, selection) to a temporary file whenever it changes.
- File: os.tmpdir()/active-context-mcp/active-context.json
The MCP server reads that file and returns the content when the AI tool calls get.

Requirements

VS Code is running with this extension installed.
Node.js and npx are available to the MCP client.
The MCP client runs on the same machine as VS Code.

When It Updates

After VS Code starts
When the active editor changes
When the selection changes
When workspace folders change

GitHub リポジトリ

機能説明

今あなたが VS Code のどこを見ているか — 開いているファイル、カーソルの位置、選択範囲 — を MCP 対応 AI ツールに伝えるための拡張機能です。

設定

先に VS Code 拡張機能をインストールしてください。そのあと、MCP 対応 AI ツールに MCP command を追加します。

mcpServers 形式の設定を使うツールでは、次の entry を追加します。

{
  "mcpServers": {
    "active_context": {
      "command": "npx",
      "args": ["-y", "active-context-mcp"]
    }
  }
}

設定場所はツールによって違います。グローバル MCP 設定ファイル、プロジェクト設定ファイル、設定 UI のどれかです。重要なのは次の値です。

command: npx
args: -y active-context-mcp

MCP ツール

MCP command は次のツールを提供します。

get

返す内容は次のとおりです。

{
  "schema": "active-context-mcp/v1",
  "workspace": "/path/to/workspace",
  "file": "/path/to/workspace/src/example.ts",
  "relativeFile": "src/example.ts",
  "cursor": {
    "line": 10,
    "character": 5
  },
  "activeLineText": "const value = example();",
  "selection": {
    "startLine": 10,
    "startCharacter": 5,
    "endLine": 10,
    "endCharacter": 5
  },
  "updatedAt": "2026-07-07T10:00:00.000Z"
}

仕組み

VS Code 拡張機能が、エディタの状態（ファイル、カーソル、選択範囲）を変更のたびに一時ファイルに書き出します。
- ファイル: os.tmpdir()/active-context-mcp/active-context.json
AI ツールが get を呼ぶと、MCP サーバーがそのファイルを読んで返します。

必要なもの

VS Code が起動していて、この拡張機能がインストールされていること。
MCP クライアントから Node.js と npx を実行できること。
MCP クライアントと VS Code が同じマシン上で動いていること。

更新タイミング

VS Code 起動後
アクティブエディタ変更時
選択範囲変更時
ワークスペースフォルダ変更時

Active Context MCP