Boilerplate MCP Server

ボイラープレート MCP サーバー

TypeScript を使用した、ボイラープレートの Model Context Protocol（MCP）サーバー実装です。このプロジェクトでは、Claude Desktop などの AI アプリケーションにツールとリソースの両方を提供する、適切に構成された MCP サーバーの構築方法を紹介します。クリーンなアーキテクチャ、自動化されたワークフロー、簡単なデプロイを重視して、MCP 互換サーバーを構築する開発者向けの出発点となります。

主な機能

• STDIO MCP サーバー：Claude Desktop などの AI クライアント向けに設計されており、Model Context Protocol を介してツールとリソースを提供します。
• CLI サポート：同じ機能を使いやすいコマンドラインインターフェースで利用でき、直接テストしたり使用したりできます。
• IP アドレスの検索：任意の IP アドレス、または現在のデバイスの IP に関する詳細を取得できます。
• リリース管理の自動化：継続的インテグレーション、テスト、GitHub Packages への公開を行う GitHub Actions ワークフローです。

インストール

グローバルインストール

このパッケージをグローバルにインストールすると、CLI ツールとして使用できます。

npm install -g @aashari/boilerplate-mcp-server

グローバルインストール後は、CLI コマンドを直接実行できます。

# Get help
boilerplate-mcp-server --help

# Get current IP details
boilerplate-mcp-server get-ip-details

# Get details for a specific IP
boilerplate-mcp-server get-ip-details 8.8.8.8

ローカルインストール

開発またはローカルでの使用では、リポジトリをクローンして依存関係をインストールします。

git clone https://github.com/aashari/boilerplate-mcp-server.git
cd boilerplate-mcp-server
npm install

次に、開発サーバーを実行します。

npm run dev

または、ビルドして起動します。

npm run build
npm start

エンドユーザー向けの設定オプション

Claude Desktop または Cursor AI で設定する前に、サーバーを構成できます。エンドユーザーには、次の 2 つの方法をおすすめします。

オプション 1：Claude/Cursor に直接設定

設定を Claude Desktop の設定ファイル、または Cursor AI のコマンドに直接渡します。

{
  "mcpServers": {
    "aashari/boilerplate-mcp-server": {
      "command": "npx",
      "args": ["-y", "DEBUG=true", "IPAPI_API_TOKEN=your_token", "aashari/boilerplate-mcp-server"]
    }
  }
}

オプション 2：グローバル設定ファイル（推奨）

1. $HOME/.mcp/configs.json にグローバル設定ファイルを作成します。

{
  "@aashari/boilerplate-mcp-server": {
    "environments": {
      "DEBUG": "true",
      "IPAPI_API_TOKEN": "your_token"
    }
  }
}

2. 次に、Claude Desktop または Cursor AI で簡略化した設定を使用します。

{
  "mcpServers": {
    "aashari/boilerplate-mcp-server": {
      "command": "npx",
      "args": ["-y", "aashari/boilerplate-mcp-server"]
    }
  }
}

この方法では、設定を 1 か所に安全に保管でき、AI アシスタントの設定も簡素化されます。

利用可能な設定オプション

• DEBUG：デバッグログを有効にするには、true に設定します。
• IPAPI_API_TOKEN：IP API サービスの API トークン（必要な場合）。

Claude Desktop での設定

この MCP サーバーを Claude Desktop で使用するには、次の手順に従います。

1. Claude Desktop の設定を開く：

   • Claude Desktop を起動します
   • 右上隅にある設定アイコン（歯車）をクリックします

   

2. MCP 設定を編集する：

   • 「設定を編集」ボタンをクリックします
   • claude_desktop_config.json ファイルを含むエクスプローラー/Finder が開きます

3. 設定ファイルを更新する：

   • 上記の設定オプションのいずれかをファイルに追加します
   • ファイルを保存します

   グローバル設定ファイルをすでに設定している場合の例：

   {
     "mcpServers": {
       "aashari/boilerplate-mcp-server": {
         "command": "npx",
         "args": ["-y", "aashari/boilerplate-mcp-server"]
       }
     }
   }
   

4. Claude Desktop を再起動する：

   • 変更を適用するため、Claude Desktop を終了して再度開きます

   

5. ツールが利用可能か確認する：

   • Claude のホーム画面の右側にあるハンマーアイコンを探します
   • アイコンをクリックして、利用可能なツールを確認します
   • get-ip-details ツールが表示されていることを確認します

   

6. ツールをテストする：

   • Claude に「自分のパブリック IP を教えて」または「この IP を分析して：8.8.8.8」と尋ねてみます
   • Claude は MCP ツールを使用して、要求された情報を取得し表示します

   

Cursor AI のセットアップ

この MCP サーバーを Cursor AI で使用するには：

1. Cursor の設定を開く：

   • Cursor を起動します
   • CMD + SHIFT + P（Windows の場合は CTRL + SHIFT + P）を押します
   • 「settings」と入力し、「Cursor Settings」を選択します
   • サイドバーで「MCP」を選択します

   

2. 新しい MCP サーバーを追加する：

   • 「+ Add new MCP server」をクリックします
   • 設定フォームが表示されます

   

3. MCP サーバーを設定する：

   • 名前：aashari/boilerplate-mcp-server を入力します
   • タイプ：ドロップダウンから command を選択します
   • コマンド：設定方法に応じて、次のいずれかを選択します

   グローバル設定ファイルを使用する場合（推奨）：

   npx -y aashari/boilerplate-mcp-server
   

   設定を直接渡す場合：

   DEBUG=true IPAPI_API_TOKEN=your_token npx -y aashari/boilerplate-mcp-server
   

   • 「Add」をクリックします

4. サーバーの設定を確認する：

   • サーバーが緑色のインジケーターとともに一覧に表示されます
   • サーバーの下に get_ip_details ツールが表示されます

   

5. ツールをテストする：

   • チャットサイドバーで、エージェントモードが有効になっていることを確認します
   • 「公開 IP を教えて」または「この IP を分析して：8.8.8.8」のように尋ねてみます
   • Cursor AI が MCP ツールを使用して、要求された情報を取得し、表示します

   

CLI ツールとしての使用

このパッケージは、人が操作するコマンドラインツールとしても使用できます：

• ヘルプと使用可能なコマンドを表示する：

  npx -y aashari/boilerplate-mcp-server --help
  

  出力例：

  Usage: @aashari/boilerplate-mcp-server [options] [command]
  
  A boilerplate Model Context Protocol (MCP) server implementation using TypeScript
  
  Options:
    -V, --version               output the version number
    -h, --help                  display help for command
  
  Commands:
    get-ip-details [ipAddress]  Get details about a specific IP address or the current device
    help [command]              display help for command
  

• 現在のデバイスの IP 詳細を取得する：

  npx -y aashari/boilerplate-mcp-server get-ip-details
  

  出力例：

  status: success
  country: Indonesia
  countryCode: ID
  region: JK
  regionName: Jakarta
  city: Jakarta
  zip: 11730
  lat: -6.2114
  lon: 106.8446
  timezone: Asia/Jakarta
  isp: Biznet Wifi
  org:
  as: AS17451 BIZNET NETWORKS
  query: 118.99.106.135
  

  • 特定の IP アドレスの詳細を取得する：

  npx -y aashari/boilerplate-mcp-server get-ip-details 8.8.8.8
  

  出力例：

  status: success
  country: United States
  countryCode: US
  region: VA
  regionName: Virginia
  city: Ashburn
  zip: 20149
  lat: 39.03
  lon: -77.5
  timezone: America/New_York
  isp: Google LLC
  org: Google Public DNS
  as: AS15169 Google LLC
  query: 8.8.8.8
  

---

MCP について

コア概念、アーキテクチャ、実装ガイドなど、Model Context Protocol（MCP）の詳細については、公式 MCP ドキュメントを参照してください。

開発者向け

このプロジェクトの開発や拡張に関心がある場合は、以下の詳細について開発ガイドを参照してください：

• 前提条件とインストール
• プロジェクト構成
• 設定システム
• 独自機能の追加
• テストとデプロイ
• 独自の MCP サーバーの作成
• その他

ライセンス

ISC