Hika MCP Server

🚀 Hika MCP 服務器

Hika MCP 服務器專為 Hika AI 知識搜索工具打造，採用 Server-Sent Events (SSE) 技術。它藉助即時流傳輸，為用戶帶來人工智能生成的觀點和知識擴展，極大地提升搜索體驗。Hika AI 作為知識搜索引擎，能從多個認知視角（MCP）分析搜索查詢，助力用戶拓寬視野、深入探索相關領域。

🚀 快速開始

先決條件

• Node.js (v14.0.0 或更高版本)
• 瞭解 Server-Sent Events (SSE)
• 擁有有效的 Hika AI 身份驗證憑證

安裝

# 克隆倉庫
git clone https://github.com/hikaai/mcp-server.git
cd mcp-server

# 安裝依賴項
npm install

# 設置環境變量
cp .env.example .env
# 使用您的憑證編輯 .env 文件

配置

設置以下環境變量：

PORT=3000
HIKA_API_URL=https://api.hika.fyi
JWT_SECRET=your_jwt_secret

或在應用中使用提供的配置：

{
  "command": "",
  "url": "https://hika.fyi/api/mcp/sse",
  "env": {
    "HIKA_AUTH": "Bearer your_jwt_token_here"
  }
}

啟動服務器

npm start

✨ 主要特性

• 通過 SSE 協議即時流傳輸人工智能生成的內容
• 提供多認知視角以增強知識探索
• 支持 JWT Bearer 令牌身份驗證
• 與 Hika AI 生態系統輕鬆集成

💻 使用示例

基礎用法

客戶端連接示例

const eventSource = new EventSource('https://hika.fyi/api/mcp/sse', {
  headers: {
    'Authorization': 'Bearer your_jwt_token_here'
  }
});

eventSource.onmessage = (event) => {
  const data = JSON.parse(event.data);
  console.log('接收的觀點:', data);
};

eventSource.onerror = (error) => {
  console.error('SSE 連接錯誤:', error);
  eventSource.close();
};

📚 詳細文檔

API 參考

SSE 端點

GET /api/mcp/sse

請求頭

• Authorization: Bearer 令牌用於身份驗證

事件類型

服務器會發出以下事件類型：

1. perspective - 搜索查詢的新人工智能生成觀點
2. knowledge_extension - 相關知識領域的擴展
3. deep_dive - 特定方面的深入分析
4. completion - 表示流的結束

事件數據格式

{
  "type": "perspective",
  "content": {
    "title": "歷史背景",
    "description": "從歷史視角看問題...",
    "relevance_score": 0.85
  }
}

認證信息

服務器使用 JWT Bearer 令牌進行身份驗證。令牌應包含在 Authorization 請求頭中：

Authorization: Bearer eyJhbGciOiJFUzM4NCIsInR5cCI6ImF0K2p3dCIs...

錯誤處理

服務器可能會返回以下錯誤代碼：

• 401 - 未授權（無效或過期令牌）
• 429 - 請求過多（速率限制）
• 500 - 內部服務器錯誤

⚠️ 重要提示

• 確保服務器運行在允許的端口上。
• 配置環境變量時，確保所有值正確無誤。
• 在生產環境中，建議啟用錯誤處理和日誌記錄功能。

通過以上步驟，您可以輕鬆設置並使用 Hika MCP 服務器來增強知識搜索體驗。