Ezanvakti.mcp.server

🚀 EzanVakti MCP Server

このプロジェクトは、C#で実装されたModel Context Protocol (MCP) サーバーで、EzanVakti API（Diyanet - トルコ宗教事務局）からイスラムの礼拝時間にアクセスすることができます。

✨ 主な機能

• 国の一覧表示：利用可能なすべての国を取得します。
• 都市検索：特定の国の都市を検索します。
• 地区検索：特定の都市の地区を取得します。
• 礼拝時間の取得：任意の地区の月間の礼拝スケジュールを取得します。
• スマート検索：都市名で検索し、その礼拝時間を取得します。
• 今日の礼拝時間：現在の日の礼拝スケジュールを取得します。

🚀 クイックスタート

前提条件

• .NET 8.0 SDK 以上
• 互換性のあるMCPクライアント（Copilot付きのVS Code、Claude Desktopなど）

📦 インストール

1. プロジェクトファイルをクローンまたはダウンロードします。
2. 依存関係を復元します：

   dotnet restore
   

3. プロジェクトをビルドします：

   dotnet build
   

サーバーの起動

開発環境での起動：

dotnet run

本番環境での起動：

dotnet publish -c Release
./bin/Release/net8.0/publish/EzanVakti.MCP.Server

📚 ドキュメント

VS Codeの設定

.vscode/mcp.jsonに以下を追加します：

{
  "mcpServers": {
    "ezanvakti": {
      "command": "dotnet",
      "args": ["run", "--project", "/path/to/EzanVakti.MCP.Server.csproj"],
      "env": {}
    }
  }
}

Claude Desktopの設定

Claude Desktopの設定に以下を追加します：

{
  "mcpServers": {
    "ezanvakti": {
      "command": "dotnet",
      "args": ["run", "--project", "/path/to/EzanVakti.MCP.Server.csproj"]
    }
  }
}

💻 使用例

1. GetCountries

EzanVaktiデータベースで利用可能なすべての国を一覧表示します。 使用例: "Show me all countries with prayer times"

2. GetCities

特定の国の都市/州を取得します。 パラメータ:

• countryId: 国のID（例: トルコの場合は "2"） 使用例: "Show me cities in Turkey"

3. GetDistricts

特定の都市の地区を取得します。 パラメータ:

• cityId: 都市のID（例: イスタンブールの場合は "539"） 使用例: "Show me districts in Istanbul"

4. GetPrayerTimes

特定の地区の月間の完全な礼拝スケジュールを取得します。 パラメータ:

• districtId: 地区のID 使用例: "Get prayer times for district 9535"

5. SearchCityPrayerTimes

都市を検索し、その礼拝時間を取得します。 パラメータ:

• cityName: 検索する都市の名前
• countryId: 国のID（デフォルトはトルコの "2"） 使用例: "Get prayer times for Istanbul"

6. GetTodayPrayerTimes

特定の地区の今日の礼拝時間を取得します。 パラメータ:

• districtId: 地区のID 使用例: "What are today's prayer times for district 9535?"

礼拝時間のデータ構造

各礼拝時間のエントリには以下が含まれます：

• 日付情報：ヒジュリ暦とグレゴリオ暦の両方の日付
• 礼拝時間：
  • Imsak: 夜明け前（スホールの時間）
  • Gunes: 日の出
  • Ogle: 正午（ズフル）
  • Ikindi: 午後（アスル）
  • Aksam: 夕方（マグリブ）
  • Yatsi: 夜（イシャ）
• 追加情報：
  • KibleSaati: キブラの時間（太陽がカーバの方向にある時間）
  • GunesDogus/GunesBatis: 正確な日の出/日の入り

サンプルクエリ

以下は、使用できる自然言語クエリの例です：

• "What are the prayer times in Istanbul?"
• "Show me all cities in Turkey"
• "Get today's prayer schedule for Ankara"
• "Find districts in Izmir"
• "What time is Maghrib prayer in Istanbul today?"

Dockerサポート

Dockerイメージをビルドします：

dotnet publish --os linux --arch x64 /t:PublishContainer

コンテナで実行します：

docker run -it ezanvakti-mcp-server:latest

APIのレート制限

EzanVakti APIには以下の制限があります：

• 5分間に30リクエスト
• 1日に200リクエスト 礼拝時間は月単位で提供されるため、通常、場所ごとに月に1回のリクエストで十分です。

🔧 技術詳細

このMCPサーバーは以下の技術で構築されています：

• ModelContextProtocol SDK：公式のC#実装
• HttpClient：適切な破棄を伴うAPI通信
• 依存性注入：関心事の分離
• ロギング：包括的なエラー追跡
• JSONシリアライズ：高速なSystem.Text.Json

コントリビュートの方法

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 変更をコミットします。
4. ブランチにプッシュします。
5. プルリクエストを作成します。

📄 ライセンス

このプロジェクトはオープンソースです。EzanVakti APIはトルコ宗教事務局によって提供されています。

サポート

問題や質問がある場合は：

• ログを確認してエラーの詳細を確認します。
• APIの接続性を確認します。
• MCPクライアントの設定が正しいことを確認します。
• 429エラーが発生する場合は、レート制限を確認します。