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. 05查看 Spotify 和 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 构建。

这是一个由个人维护的项目，也是我的第一个开源项目。本仓库公开托管，方便大家报告 Bug、提出改进建议并提交小而专注的拉取请求。我还在学习开源协作，因此多一些耐心和清晰的沟通会很有帮助。

状态

  • 生产网站：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）

本项目使用 Neon 无服务器 Postgres 和 Drizzle ORM。

  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 中，不要提交。

贡献

欢迎提出想法、报告 Bug 和提交小型 PR。

如果你想参与，最简单的方式是：

  • 提交 issue
  • 让想法或修复保持小而精
  • 用通俗易懂的语言说明问题

推荐的参与方式：

  • 为 Bug 或功能建议提交 issue
  • 提交一次只解决一个问题的专注 PR
  • 修改 UI 时附上截图
  • 如果行为发生变化，请更新文档

简要了解本仓库的维护方式，请参阅 CONTRIBUTING.md。

安全

请勿公开发布安全问题。请参阅 SECURITY.md。

部署

生产应用通过 OpenNext 部署在 Cloudflare Workers 上。 贡献者通常不需要部署权限。

维护者部署命令：

pnpm deploy

项目说明

  • 部分外部播放列表访问可能需要 Spotify Extended Quota Mode。
  • 对于 API 数据有限或不可用的情况，应用在 src/data/manual/ 中提供了手动数据回退。

许可证

MIT。请参阅 LICENSE。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。