mcpField
G
GospelChannel Church Finder

GospelChannel Church Finder

リモート
gospelchannel.com地図・旅行01 日前に更新
リポジトリ公式サイト

GospelChannel Church Finder について

GospelChannel Church Finderは、参加先を探す人向けの教会ガイドです。場所、伝統、言語、礼拝スタイル、礼拝の詳細で比較でき、教会ページでは音楽や動画も確認できます。

主な機能

  1. 01場所や伝統で教会を比較
  2. 02言語や礼拝スタイルで絞り込み
  3. 03礼拝の詳細を確認
  4. 04厳選された賛美・ゴスペル音楽
  5. 05SpotifyとYouTubeの埋め込み表示

活用シーン

  1. 01初めて訪れる教会を探す
  2. 02礼拝スタイルで地域の教会を比較
  3. 03教会プロフィールに関連する音楽を探す

設定

リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。

エンドポイントhttps://gospelchannel.com/mcp
インストールコマンドをコピー
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。

ツール

3
パラメーター型必須説明
limitnumberいいえ返す教会の最大数(デフォルトは 5、最大 20)。
languagestringいいえ希望する礼拝言語。例:English、Spanish。
radius_kmnumberいいえ検索半径(キロメートル単位、デフォルトは 40、最大 500)。
denominationstringいいえ希望する教派。例:non-denominational、Baptist、Pentecostal、Assemblies of God。
worship_stylestringいいえ希望する礼拝スタイル。例:contemporary、gospel、charismatic、traditional、hillsong。

詳細

GospelChannel — 教会ガイド

初めて訪れる前に、自分に合った教会を見つけましょう。

礼拝の特徴がわかるプロフィールを備えた、無料のグローバルな教会ガイドです。Next.js 16、Cloudflare Workers 上の OpenNext、Neon、Spotify、YouTube を使用して構築されています。

個人でメンテナンスしているプロジェクトで、初めてのオープンソースプロジェクトでもあります。このリポジトリを公開しているのは、バグの報告、改善案の提案、小規模で焦点を絞ったプルリクエストの送信を歓迎するためです。オープンソースの進め方についてはまだ学んでいるところなので、気長に、わかりやすく伝えていただけると助かります。

ステータス

  • 本番サイト:https://gospelchannel.com
  • コントリビューターが使用する言語:英語またはスウェーデン語
  • プロジェクトの方針はメンテナーが主導します

アプリでできること

  • 場所、伝統、言語、礼拝スタイル、礼拝の詳細から教会を見つけて比較できます
  • 教会のプロフィールに関連付けられた、厳選された礼拝音楽やゴスペル音楽を閲覧できます
  • Spotify の埋め込みや YouTube の動画グリッドを備えた教会のページを閲覧できます
  • 教会の候補や所有権の申請を送信できます
  • コンテンツを定期的に更新するジョブを実行できます
  • sitemap.xml、robots.txt、構造化データなどの SEO アセットを生成できます

技術スタック

  • Next.js 16(App Router)
  • OpenNext + Cloudflare Workers
  • Neon Postgres + Drizzle
  • Better Auth
  • Spotify Web API
  • YouTube Data API
  • メディア向け Cloudflare R2
  • アナリティクス向け PostHog

ローカル環境のセットアップ

前提条件:

  • Node 22.x
  • npm

nvm を使用する場合は、次を実行します。

nvm use

インストールして起動します。

pnpm install
cp .env.example .env.local
pnpm dev

便利なコマンド:

pnpm lint
pnpm build
pnpm smoke
pnpm check:env

データベース(Neon)

このプロジェクトでは、Drizzle ORM とともに Neon のサーバーレス Postgres を使用しています。

  1. neon.tech で無料のプロジェクトを作成します
  2. 接続文字列を .env.local にコピーします:
    • DATABASE_URL - プール接続文字列
    • DATABASE_URL_UNPOOLED - 直接接続(Drizzle のマイグレーションで使用)
  3. マイグレーションを実行します:
    npx drizzle-kit push
    

環境変数

コードの確認やドキュメント、UI の作業には、すべての外部連携が必要なわけではありません。

一般的なローカル開発:

  • NEXT_PUBLIC_SITE_URL
  • NEXT_PUBLIC_MEDIA_BASE_URL
  • BETTER_AUTH_URL
  • BETTER_AUTH_SECRET
  • DATABASE_URL

特定の連携や本番環境に近いフローで必要な環境変数:

  • YOUTUBE_API_KEY
  • SPOTIFY_CLIENT_ID
  • SPOTIFY_CLIENT_SECRET
  • APIFY_TOKEN
  • ANTHROPIC_API_KEY
  • BREVO_API_KEY
  • CRON_SECRET

管理者権限はデータベースで管理されています。 次のコマンドでアカウントを管理者に昇格できます。

pnpm db:seed -- [email protected]

注意事項:

  • pnpm build はコンテンツパイプラインでオフラインモードを使用します。
  • 管理機能、メール、同期、デプロイの全フローには、実際のサービス認証情報が必要です。
  • シークレットは .env.local に保存してください。コミットしないでください。

コントリビューション

アイデア、バグ報告、小規模なプルリクエストを歓迎します。

協力する場合は、次の方法が最も簡単です。

  • イシューを作成する
  • アイデアや修正の規模を小さく保つ
  • 問題を平易な言葉で説明する

特に歓迎する協力方法:

  • バグや機能のアイデアについてイシューを作成する
  • 一度に1つの問題を解決する、焦点を絞ったプルリクエストを送る
  • UI を変更する場合はスクリーンショットを添付する
  • 動作が変わる場合はドキュメントを更新する

このリポジトリの運用方法の概要については、CONTRIBUTING.md をご覧ください。

セキュリティ

セキュリティ上の問題を公開の場に投稿しないでください。SECURITY.md をご覧ください。

デプロイ

本番アプリは OpenNext 経由で Cloudflare Workers にデプロイされています。 通常、コントリビューターにデプロイへのアクセス権は必要ありません。

メンテナーのデプロイコマンド:

pnpm deploy

プロジェクトに関する注意事項

  • 外部のプレイリストにアクセスする場合、Spotify の Extended Quota Mode が必要になることがあります。
  • API のデータが限られている場合や利用できない場合に備えて、アプリには src/data/manual/ に手動のデータフォールバックがあります。

ライセンス

MIT。LICENSE をご覧ください。

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。