Linkwarden MCP

プラグイン（URL、キー、スコープは Configure UI で設定）： このリポジトリは .cursor-plugin/plugin.json とルートの mcp.json を使った Cursor プラグインです。

1. クローンを ~/.cursor/plugins/local/linkwarden-mcp にシンボリックリンクするか、コピーします（Windows の場合：%USERPROFILE%\.cursor\plugins\local\linkwarden-mcp）。
   • macOS / Linux: ln -s /path/to/linkwarden-mcp ~/.cursor/plugins/local/linkwarden-mcp
   • Windows: Cursor はローカルプラグインのシンボリックリンクをたどりません。代わりにジャンクションを作成するか、コピーしてください：

     mklink /J "%USERPROFILE%\.cursor\plugins\local\linkwarden-mcp" "E:\Development\linkwarden-mcp"
     

     または：

     robocopy "E:\Development\linkwarden-mcp" "%USERPROFILE%\.cursor\plugins\local\linkwarden-mcp" /E
     

2. ウィンドウを再読み込みします。
3. linkwarden-mcp の Plugins → Configure を開きます。Linkwarden API URL と Linkwarden API key を設定します。読み取り専用で使用する場合は Write scopes / Delete scopes を空欄のままにするか、links,collections のような CSV を貼り付けます。
4. Customize / MCP で linkwarden MCP サーバーが有効になっていることを確認します。

マーケットプレイスへの掲載は、cursor.com/marketplace/publish で別途申請してください。

手動で mcp.json を設定する場合： プロジェクトの .cursor/mcp.json またはユーザー共通の ~/.cursor/mcp.json を使用します。ルートの mcp.json は ${…} プレースホルダーのみを含むプラグイン設定用ファイルです。実際のシークレットは絶対にコミットしないでください。

PyPI から：

{
  "mcpServers": {
    "linkwarden": {
      "type": "stdio",
      "command": "uvx",
      "args": ["linkwarden-mcp"],
      "env": {
        "LINKWARDEN_API_URL": "https://links.example.com",
        "LINKWARDEN_API_KEY": "your-token"
      }
    }
  }
}

ローカルで編集可能な状態で実行（開発用）：

{
  "mcpServers": {
    "linkwarden": {
      "type": "stdio",
      "command": "uv",
      "args": ["run", "--directory", "/path/to/linkwarden-mcp", "linkwarden-mcp"],
      "env": {
        "LINKWARDEN_API_URL": "https://links.example.com",
        "LINKWARDEN_API_KEY": "your-token"
      }
    }
  }
}

env ブロックで書き込みスコープを任意に指定できます：

"LINKWARDEN_MCP_WRITE_SCOPES": "links,collections",
"LINKWARDEN_MCP_DELETE_SCOPES": "links"

保存後に Cursor を再起動します。MCP の設定で linkwarden を確認してください。

デスクトップ拡張機能（.mcpb）： GitHub Releases から mcpb.mcpb をダウンロードします。v0.1.5+ を使用してください（PATH 上に uv が必要です）。起動コマンドは uv tool run --python 3.12 linkwarden-mcp です。PyPI パッケージを mcpb/pyproject.toml の依存関係に追加しないでください。インストール時に Claude Desktop がこのファイルを同期するため、システムの Python 3.13 では失敗する場合があります。

1. Claude Desktop を開き、Settings → Extensions を選択します。
2. Advanced settings → Install Extension… を開きます。
3. mcpb.mcpb を選択します。権限を確認し、Linkwarden API URL と Linkwarden API key を入力してから、Install をクリックします。
4. 読み取り専用にする場合は、Write scopes と Delete scopes を空欄にします。
5. ツールが表示されない場合は、Claude Desktop を再起動します。

クローンから独自のバンドルをビルドします：

npx @anthropic-ai/mcpb pack mcpb

Windows では、ダブルクリックしても何も起こらないことが多く、ファイルをチャットにドラッグするとインストールではなく会話に添付されます。Settings の Install Extension… を使用してください。

手動での claude_desktop_config.json の代替手順： Claude Desktop の設定を編集してから、アプリを再起動します。

{
  "mcpServers": {
    "linkwarden": {
      "command": "uvx",
      "args": ["linkwarden-mcp"],
      "env": {
        "LINKWARDEN_API_URL": "https://links.example.com",
        "LINKWARDEN_API_KEY": "your-token"
      }
    }
  }
}

ローカルクローン：

{
  "mcpServers": {
    "linkwarden": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/linkwarden-mcp", "linkwarden-mcp"],
      "env": {
        "LINKWARDEN_API_URL": "https://links.example.com",
        "LINKWARDEN_API_KEY": "your-token"
      }
    }
  }
}

CLI から追加します：

claude mcp add linkwarden --env LINKWARDEN_API_URL=https://links.example.com --env LINKWARDEN_API_KEY=your-token -- uvx linkwarden-mcp

または、~/.claude.json / プロジェクトの MCP 設定を編集します：

{
  "mcpServers": {
    "linkwarden": {
      "command": "uvx",
      "args": ["linkwarden-mcp"],
      "env": {
        "LINKWARDEN_API_URL": "https://links.example.com",
        "LINKWARDEN_API_KEY": "your-token"
      }
    }
  }
}

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

{
  "servers": {
    "linkwarden": {
      "type": "stdio",
      "command": "uvx",
      "args": ["linkwarden-mcp"],
      "env": {
        "LINKWARDEN_API_URL": "https://links.example.com",
        "LINKWARDEN_API_KEY": "your-token"
      }
    }
  }
}

ローカルで編集可能：

{
  "servers": {
    "linkwarden": {
      "type": "stdio",
      "command": "uv",
      "args": ["run", "--directory", "/path/to/linkwarden-mcp", "linkwarden-mcp"],
      "env": {
        "LINKWARDEN_API_URL": "https://links.example.com",
        "LINKWARDEN_API_KEY": "your-token"
      }
    }
  }
}

ウィンドウを再読み込みします。Copilot Chat を開き、linkwarden ツールが使用可能であることを確認します。

~/.codeium/windsurf/mcp_config.json（macOS/Linux）または Windsurf MCP 設定 UI を編集します：

{
  "mcpServers": {
    "linkwarden": {
      "command": "uvx",
      "args": ["linkwarden-mcp"],
      "env": {
        "LINKWARDEN_API_URL": "https://links.example.com",
        "LINKWARDEN_API_KEY": "your-token"
      }
    }
  }
}

保存後、Windsurf を再起動します。

Zed の settings.json の context_servers の下に追加します（Agent Panel → settings からも設定できます）：

{
  "context_servers": {
    "linkwarden": {
      "command": "uvx",
      "args": ["linkwarden-mcp"],
      "env": {
        "LINKWARDEN_API_URL": "https://links.example.com",
        "LINKWARDEN_API_KEY": "your-token"
      }
    }
  }
}

Cline MCP 設定ファイル（Cline MCP UI から開く cline_mcp_settings.json）を編集します：

{
  "mcpServers": {
    "linkwarden": {
      "command": "uvx",
      "args": ["linkwarden-mcp"],
      "env": {
        "LINKWARDEN_API_URL": "https://links.example.com",
        "LINKWARDEN_API_KEY": "your-token"
      }
    }
  }
}

.continue/config.yaml で設定します：

mcpServers:
  - name: linkwarden
    command: uvx
    args:
      - linkwarden-mcp
    env:
      LINKWARDEN_API_URL: https://links.example.com
      LINKWARDEN_API_KEY: your-token

stdio MCP サーバーを起動できるホストであれば使用できます：

uvx linkwarden-mcp

クローンから開発する場合：uv run --directory /path/to/linkwarden-mcp linkwarden-mcp。

npx で実行できるのは npm パッケージのみです。これは Python パッケージなので、uvx を使用してください。