Unofficial dubco-mcp-server

非公式 dubco-mcp-server

Dub.co の短縮リンクを作成、管理するための Model Context Protocol（MCP）サーバーです（非公式）。このサーバーを使うと、AI アシスタントは Dub.co API を通じて短縮リンクを作成、更新、削除できます。

🚀 機能

• Dub.co ドメインを使ったカスタム短縮リンクの作成
• 既存の短縮リンクの更新
• 短縮リンクの削除
• Model Context Protocol を通じた AI アシスタントとのシームレスな統合

📋 前提条件

• Node.js 16.0.0 以降
• API アクセスが可能な Dub.co アカウント
• Dub.co ダッシュボードの API キー

💻 インストール

Smithery 経由でのインストール

Smithery 経由で Claude Desktop 用 Dub.co MCP Server を自動的にインストールするには：

npx -y @smithery/cli install @Gitmaxd/dubco-mcp-server-npm --client claude

グローバルインストール

npm install -g dubco-mcp-server

ローカルインストール

npm install dubco-mcp-server

npx で直接使用

npx dubco-mcp-server

⚙️ 設定

この MCP サーバーを使用するには、Dub.co API キーが必要です。API キーはDub.co ダッシュボードから取得できます。

API キーを環境変数として設定します：

export DUBCO_API_KEY=your_api_key_here

設定を永続化するには、シェルプロファイル（例：.bashrc、.zshrc）に次の内容を追加します：

echo 'export DUBCO_API_KEY=your_api_key_here' >> ~/.zshrc

🖥️ Cursor IDE のセットアップ

Cursor IDE は MCP サーバーをネイティブにサポートしています。次の手順に従って、Cursor に dubco-mcp-server をセットアップします：

ステップ 1：Cursor IDE をインストールする

まだインストールしていない場合は、Cursor IDE（バージョン 0.4.5.9 以降）をダウンロードしてインストールします。

ステップ 2：Cursor の設定を開く

1. Cursor IDE を開きます
2. 左下隅の歯車アイコンをクリックするか、キーボードショートカット Cmd+,（Mac）または Ctrl+,（Windows/Linux）を使います
3. Features セクションに移動します
4. 下にスクロールして「MCP Servers」セクションを見つけます

ステップ 3：MCP サーバーを追加する

1. 「+ Add new MCP server」をクリックします
2. 表示されたダイアログで、次の項目を設定します：
   • 名前：「Dub.co MCP Server」と入力します（または任意の名前を指定します）
   • 種類：ドロップダウンから「command」を選択します
   • コマンド：env DUBCO_API_KEY=your_api_key_here npx -y dubco-mcp-server と入力します （your_api_key_here を実際の Dub.co API キーに置き換えてください）
3. 「Save」をクリックしてサーバーを追加します

ステップ 4：接続を確認する

MCP サーバーを追加すると、サーバー名の横に緑色のステータスインジケーターが表示されます。赤色または黄色のステータスが表示される場合は、次を試してください：

1. API キーが正しいことを確認する
2. Cursor IDE を再起動する
3. Node.js（16.0.0 以降）が正しくインストールされていることを確認する

ステップ 5：サーバーを使用する

dubco-mcp-server は、Cursor の AI 機能で使用できるツールを提供します：

1. Cursor の Composer または Agent モードを開きます（MCP はこれらのモードでのみ動作します）
2. Dub.co ツール（create_link、update_link、delete_link）を使用するよう AI に明示的に指示します
3. ツールの使用確認が表示されたら、使用を承認します

🔧 MCP での使用

このサーバーは、Model Context Protocol を通じて AI アシスタントが使用できるツールを提供します。MCP 対応の AI アシスタントで使用するには、MCP 設定に追加してください。

MCP 設定例

{
  "mcpServers": {
    "dubco": {
      "command": "npx",
      "args": ["-y", "dubco-mcp-server"],
      "env": {
        "DUBCO_API_KEY": "your_api_key_here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

利用可能なツール

create_link

Dub.co で新しい短縮リンクを作成します。

パラメーター：

{
  "url": "https://example.com",
  "key": "optional-custom-slug",
  "externalId": "optional-external-id",
  "domain": "optional-domain-slug"
}

例：

{
  "url": "https://github.com/gitmaxd/dubco-mcp-server-npm",
  "key": "dubco-mcp"
}

update_link

Dub.co の既存の短縮リンクを更新します。

パラメーター：

{
  "linkId": "link-id-to-update",
  "url": "https://new-destination.com",
  "domain": "new-domain-slug",
  "key": "new-custom-slug"
}

例：

{
  "linkId": "clwxyz123456",
  "url": "https://github.com/gitmaxd/dubco-mcp-server-npm/releases"
}

delete_link

Dub.co の短縮リンクを削除します。

パラメーター：

{
  "linkId": "link-id-to-delete"
}

例：

{
  "linkId": "clwxyz123456"
}

🔍 仕組み

サーバーは API キーを使用して Dub.co API に接続し、Model Context Protocol を通じて AI アシスタントが Dub.co を操作するための標準化されたインターフェースを提供します。ツールが呼び出されると、次の処理を行います。

1. サーバーが入力パラメーターを検証します
2. Dub.co API に適切なリクエストを送信します
3. レスポンスを処理し、AI アシスタントが理解できる形式で返します

🛠️ 開発

ソースからのビルド

git clone https://github.com/gitmaxd/dubco-mcp-server-npm.git
cd dubco-mcp-server-npm
npm install
npm run build

開発モードでの実行

npm run dev

📝 ライセンス

このプロジェクトは ISC ライセンスの下でライセンスされています。詳細については、LICENSE ファイルを参照してください。

🔗 リンク

• Dub.co - URL 短縮サービス
• Dub.co API ドキュメント
• Model Context Protocol - MCP の詳細はこちら

👥 コントリビューション

コントリビューションを歓迎します！お気軽にプルリクエストを送信してください。

1. リポジトリをフォークします
2. フィーチャーブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m 'Add some amazing feature'）
4. ブランチにプッシュします（git push origin feature/amazing-feature）
5. プルリクエストを作成します

👨‍💻 作成者

この非公式 Dub.co MCP サーバーは、GitMaxd（X の @gitmaxd）によって作成されました。

このプロジェクトは、Model Context Protocol と MCP サーバーの構築方法を理解するための学習課題として開発されました。API がシンプルで実用性が高いことから、学習プロジェクトに理想的な連携先として Dub.co を選びました。

Dub.co との公式な関係はありませんが、手動での短縮リンク作成にも自動での作成にも、このサービスを強くおすすめします。API のドキュメントは充実しており、使いやすいため、この種の連携に最適です。

このプロジェクトがお役に立った場合や改善の提案がある場合は、お気軽にご連絡いただくか、リポジトリにコントリビューションしてください。リンク短縮をお楽しみください！