Mcphubs

🚀 MCPHubs - 模型上下文协议项目中心

MCPHubs 是一个专门展示与 Anthropic 的 Model Context Protocol (MCP) 相关项目的网站。它借助 Next.js 构建而成，具备强大的功能，能够帮助用户高效地搜索、分析和了解 MCP 相关项目。

🚀 快速开始

MCPHubs 是一个展示与 Anthropic 的 Model Context Protocol (MCP) 相关项目的网站。该网站使用 Next.js 构建，以下为你介绍如何快速开启使用之旅。

本地开发

1. 克隆仓库

git clone https://github.com/yourusername/mcphubs.git
cd mcphubs

2. 安装依赖

npm install

3. 配置环境变量 创建 .env.local 文件并添加以下内容：

# GitHub API 令牌（可选，但推荐使用以避免 API 速率限制）
GITHUB_TOKEN=your_github_token_here

# Google Cloud Vertex AI 配置
GOOGLE_CLOUD_PROJECT=your-project-id
GOOGLE_CLOUD_LOCATION=us-central1
GOOGLE_APPLICATION_CREDENTIALS=./google-credentials.json
VERTEX_LOCATION=us-central1

4. 配置 Google Cloud 服务账号 将您的 Google Cloud 服务账号凭证文件（JSON 格式）放在项目根目录下，文件名与 GOOGLE_APPLICATION_CREDENTIALS 环境变量中指定的名称一致。 如果您还没有服务账号，可以按照以下步骤创建：

• 前往 Google Cloud Console
• 选择您的项目
• 导航到 "IAM & Admin" > "Service Accounts"
• 创建新的服务账号，并授予必要的权限（Vertex AI 使用者）
• 创建并下载 JSON 密钥文件
• 将文件放在项目根目录下

5. 启动开发服务器

./start-dev.sh

6. 访问项目 在浏览器中访问 http://localhost:3001（或控制台显示的其他端口）

部署

该项目可以部署到 Vercel、Netlify 或其他支持 Next.js 的平台。 部署时，请确保设置以下环境变量：

• GITHUB_TOKEN
• GOOGLE_CLOUD_PROJECT
• GOOGLE_CLOUD_LOCATION
• GOOGLE_APPLICATION_CREDENTIALS
• VERTEX_LOCATION

对于云平台部署，您可能需要将 Google Cloud 凭据作为环境变量直接设置，而不是使用文件。

✨ 主要特性

• 环境自适应代理：在开发环境自动使用代理解决 CORS 问题，在生产环境直接调用 API，让开发与生产环境无缝切换。
• GitHub API 集成：通过集成 GitHub API，能够精准搜索与 MCP 相关的项目。
• AI 分析：借助 Google Gemini Pro 对项目内容进行分析，准确评估项目与 MCP 的相关性。
• 响应式设计：采用响应式设计理念，适配各种设备尺寸，为用户提供一致的优质体验。

📦 安装指南

克隆与安装

# 克隆仓库
git clone https://github.com/yourusername/mcphubs.git
cd mcphubs

# 安装依赖
npm install

环境配置

创建 .env.local 文件并添加相关环境变量，同时配置 Google Cloud 服务账号。具体配置内容见上文“快速开始 - 本地开发”部分。

💻 使用示例

基础用法

启动开发服务器后，在浏览器中访问项目地址 http://localhost:3001，即可开始使用 MCPHubs 的各项功能，如搜索项目、查看项目详情等。

📚 详细文档

功能概述

• 项目搜索：通过 GitHub API 搜索与 MCP 相关的项目，让您快速找到所需资源。
• AI 分析：使用 Google Gemini Pro 对项目内容进行分析，评估其与 MCP 的相关性，为您筛选出高相关度的项目。
• 项目展示：清晰显示项目的列表和详细信息，方便您全面了解项目情况。
• README 渲染：使用 React Markdown 显示项目的 README 内容，让您快速掌握项目要点。

代理配置说明

该项目具有环境自适应的代理配置：

• 开发环境：自动启用 API 代理，解决本地开发时的 CORS 问题。
  • GitHub API: /api/github/* → https://api.github.com/*
  • Vertex AI: /api/vertex/* → https://us-central1-aiplatform.googleapis.com/v1/*
• 生产环境：自动禁用代理，直接调用外部 API。这种配置无需手动切换，系统会根据 NODE_ENV 环境变量自动决定是否使用代理。

🔧 技术细节

技术栈

📄 许可证

该项目遵守 麻省理工学院许可协议。