クイックスタートAuto MCP：オールインワンのClaudeデスクトップとカーソル

英語|韓国語

導入

クイックスタート Auto MCP は、 Claude Desktop および Cursor に Anthropic の Model Context Protocol (MCP) を簡単かつ迅速に登録するのに役立つツールです。

主な利点:

クイックセットアップ: ツールを実行し、生成された JSON ファイルをコピー/貼り付けするだけで、Claude Desktop と Cursor に MCP 機能を追加できます。
様々なツールをご用意：MCPの便利なツールを継続的に更新しています。スターを付けてフォローして、あなただけのツールキットの最新情報を入手しましょう。 :)

Related MCP server: Hello-MCP

特徴

RAG (Retrieval Augmented Generation) - PDF ドキュメントのキーワード、セマンティック、ハイブリッド検索機能
Dify 外部ナレッジ API - Dify の外部ナレッジ API を介したドキュメント検索機能
Dify Workflow - Dify Workflow を実行して結果を取得する
Web検索- Tavily APIを使用したリアルタイムWeb検索
自動JSON生成- Claude DesktopとCursorに必要なMCP JSONファイルを自動生成します

プロジェクト構造

.
├── case1                     # RAG example
├── case2                     # Dify External Knowledge API example
├── case3                     # Dify Workflow example
├── case4                     # Web Search example
├── data                      # Example data files
├── docs                      # Documentation folder
│   ├── case1.md           # case1 description 🚨 Includes tips for optimized tool invocation
│   ├── case2.md           # case2 description
│   ├── case3.md           # case3 description
│   ├── case4.md           # case4 description
│   └── installation.md    # Installation guide
├── .env.example              # .env example format
├── pyproject.toml            # Project settings
├── requirements.txt          # Required packages list
└── uv.lock                   # uv.lock

要件

Python >= 3.11
Claude Desktop または Cursor (MCP 対応バージョン)
uv（推奨）またはpip

インストール

1. リポジトリをクローンする

git clone https://github.com/teddynote-lab/mcp.git
cd mcp

2. 仮想環境をセットアップする

uvの使用（推奨）

# macOS/Linux
uv venv
uv pip install -r requirements.txt

# Windows
uv venv
uv pip install -r requirements_windows.txt

pipの使用

python -m venv .venv

# Windows
.venv\Scripts\activate
pip install -r requirements_windows.txt

# macOS/Linux
source .venv/bin/activate

pip install -r requirements.txt

3. PDFファイルの準備

RAG に必要な PDF ファイルを./dataディレクトリに用意してください。

構成

各ケースを実行するには、 .envファイルが必要です。ルートディレクトリにある.env.exampleファイルに必要な環境変数を指定し、ファイル名を.envに変更してください。

各ケースに必要な環境変数を設定するためのサイト

使用法

1. JSONファイルを生成する

必要な JSON ファイルを生成するには、各ケースディレクトリで次のコマンドを実行します。

# Activate virtual environment

# Windows
.venv\Scripts\activate

# macOS/Linux
source .venv/bin/activate

# Navigate to example directory
cd case1

# Generate JSON file
python auto_mcp_json.py

2. Claude Desktop/CursorにMCPを登録する

Claudeデスクトップまたはカーソルを起動する
MCP設定メニューを開く
生成されたJSONコンテンツをコピーして貼り付けます
保存してrestart

注：Claude DesktopまたはCursorを実行すると、MCPサーバーも自動的に起動します。ソフトウェアを終了すると、MCPサーバーも終了します。

トラブルシューティング

よくある問題と解決策:

MCPサーバー接続失敗：サービスが正常に動作しているか、ポートの競合がないか確認してください。特に、case2を適用する場合は、 dify_ek_server.pyも実行する必要があります。
API キーエラー: 環境変数が正しく設定されていることを確認してください。
仮想環境の問題: Python バージョンが 3.11 以上であることを確認してください。