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 環境變量自動決定是否使用代理。

🔧 技術細節

技術棧

📄 許可證

該項目遵守 麻省理工學院許可協議。