Hika MCP Server

🚀 Hika MCP サーバー

Hika MCP サーバーは、Hika AI 知識検索ツール用に設計された Server-Sent Events (SSE) の実装です。このサーバーコンポーネントは、リアルタイムストリーミングにより検索体験を向上させ、人工知能によって生成された見解と知識の拡張を提供します。

Hika AI は知識検索エンジンで、人工知能を利用して複数の認知視点 (MCP) から検索クエリを分析し、ユーザーが視野を広げ、関連分野を探索したり、特定の問題の各方面を深く掘り下げたりするのを支援します。

🚀 クイックスタート

Hika MCP サーバーを使用することで、Hika AI 知識検索ツールの検索体験を強化できます。以下の手順に従って、サーバーをセットアップして使用しましょう。

✨ 主な機能

• SSE プロトコルを通じて人工知能によって生成されたコンテンツをリアルタイムでストリーミングする
• 多認知視点を提供し、知識探索を強化する
• JWT Bearer トークンによる認証をサポートする
• Hika AI エコシステムと簡単に統合できる

📦 インストール

前提条件

• 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

クライアント接続の例

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 - 内部サーバーエラー

⚠️ 重要提示

• サーバーが許可されたポートで実行されていることを確認してください。
• 環境変数を設定する際には、すべての値が正しいことを確認してください。
• 本番環境では、エラー処理とログ記録機能を有効にすることをおすすめします。