Mylocation MCP

🚀 MCPサーバーTypeScript起動プロジェクト

このプロジェクトは、モデルコンテキストプロトコル（MCP）に基づく位置サービスサーバーの実装です。TypeScriptを使用してMCPサーバーを構築する方法を示し、座標またはIPアドレスによる位置検索機能を提供します。

✨ 主な機能

• TypeScriptの設定
• 完全なMCPサーバーのセットアップ
• 位置サービスの実装
  • 座標に基づく地理位置情報の検索
  • IPに基づく位置検索（IPInfo.ioを使用）
  • ヘルスチェックエンドポイント
• 型安全な開発環境
• 外部APIの統合

📦 インストール

npm install mylocation-mcp

💻 使用例

基本的な使用法

1. .envファイルを作成し、IPInfo.ioのAPIトークンを追加します。

IPINFO_TOKEN=your_ipinfo_token_here

2. コード内でインポートして使用します。

import { McpServer } from 'mylocation-mcp';

高度な使用法

もしこのプロジェクトを修正したり、貢献したい場合は：

# リポジトリをクローン
git clone https://github.com/yhwancha/mylocation-mcp.git
cd mylocation-mcp

# 依存関係をインストール
npm install

# 環境変数を設定
cp .env.example .env
# .envを編集し、IPInfo.ioのAPIトークンを追加

# プロジェクトをビルド
npm run build

📚 ドキュメント

プロジェクト構造

.
├── src/
│   └── index.ts    # 主サーバー実装ファイル、位置ツールを含む
├── build/           # コンパイル後のJavaScriptファイル
├── package.json    # プロジェクトの依存関係とスクリプト
├── tsconfig.json   # TypeScriptの設定
├── .env.example    # 環境変数のテンプレート
└── README.md      # ドキュメント

実装済みのツール

1. 座標から位置を取得する

server.tool(
  "get-location-by-coordinates",
  "提供された座標から地理位置情報を取得する",
  {
    latitude: z.string().describe("緯度座標（-90から90の間）"),
    longitude: z.string().describe("経度座標（-180から180の間）")
  },
  async ({ latitude, longitude }) => {
    // 実装詳細...
  }
);

2. IPから位置を取得する

server.tool(
  "get-location-by-ip",
  "IPアドレスから地理位置情報を取得する",
  {
    ipAddress: z.string().describe("検索するIPアドレス")
  },
  async ({ ipAddress }) => {
    // 実装詳細...
  }
);

3. ヘルスチェック

server.tool(
  "health",
  "サービスのヘルス状態をチェックする",
  {},
  async () => {
    // 実装詳細...
  }
);

MCPサーバーの設定

このMCPサーバーをあなたのプロジェクトで使用するには、以下の設定を追加します。

{
    "mcpServers": {
        "location-service": {
            "command": "npx",
            "args": [
              "-y",
              "mylocation-mcp-server"
            ],
            "env": {
              "IPINFO_TOKEN": <IPINFO_TOKEN>
            }
        }
    }
}

応答形式

すべてのツールが返す応答は、以下のJSON構造に従います。

{
  "code": number,
  "data": object | null,
  "message": string
}

• code: 応答のステータスコード（整数）
• data: データオブジェクトまたはnull
• message: 応答メッセージ（文字列）

依存関係

• express: シンプルで効率的なWebサーバーフレームワーク。
• cors: クロスオリジンリクエストを許可するミドルウェア。
• 設定項: 環境変数の管理機能を提供します。

📄 ライセンス

MIT License

このプロジェクトを通じて、あなたは簡単に地理位置サービスをアプリに統合し、位置関連の操作を行うことができます。