Server Hika

Hika MCP Server

概要

Hika MCP Server は、Hika AI ナレッジ検索ツール向けの Server-Sent Events（SSE）実装です。このサーバーコンポーネントは、AI が生成した視点やナレッジ拡張をリアルタイムにストリーミングし、検索体験を向上させます。

Hika AI は、人工知能を使用して検索クエリに対する複数の認知的視点（MCP）を提供するナレッジ検索ツールです。関連するナレッジ領域を探索したり、質問の具体的な側面を掘り下げたりすることで、ユーザーの理解を深めるのに役立ちます。

特長

• SSE プロトコルによる AI 生成コンテンツのリアルタイムストリーミング
• ナレッジの探索を深める複数の認知的視点
• JWT Bearer トークンによる認証
• Hika AI エコシステムとの簡単な統合

前提条件

• Node.js（v14.0.0 以降）
• Server-Sent Events（SSE）の知識
• 有効な Hika AI 認証情報

インストール

# Clone the repository
git clone https://github.com/hikaai/mcp-server.git
cd mcp-server

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env
# Edit .env with your credentials

設定

次の環境変数を設定してください。

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('Received perspective:', data);
};

eventSource.onerror = (error) => {
  console.error('SSE connection error:', error);
  eventSource.close();
};

API リファレンス

SSE エンドポイント

GET /api/mcp/sse

ヘッダー

• Authorization：認証用の Bearer トークン

イベント

サーバーは次のイベントタイプを出力します。

1. perspective - 検索クエリに対する新しい AI 生成の視点
2. knowledge_extension - 関連する追加のナレッジ領域
3. deep_dive - 特定の側面に関する詳細な分析
4. completion - ストリームの終了を通知

イベントデータ形式

{
  "type": "perspective",
  "content": {
    "title": "Historical Context",
    "description": "Looking at the question from a historical perspective...",
    "relevance_score": 0.85
  }
}

認証

サーバーは認証に JWT Bearer トークンを使用します。トークンは次のように Authorization ヘッダーに含めてください。

Authorization: Bearer eyJhbGciOiJFUzM4NCIsInR5cCI6ImF0K2p3dCIs...

エラー処理

サーバーは次のエラーコードを返す場合があります。

• 401 - 認証されていません（トークンが無効または期限切れです）
• 429 - リクエストが多すぎます（レート制限を超過しました）
• 500 - 内部サーバーエラー

開発

開発モードでの実行

npm run dev

テストの実行

npm test

Hika AI との統合

このサーバーコンポーネントは、Hika AI ナレッジ検索ツールとシームレスに連携するよう設計されています。統合すると、AI が生成した視点をリアルタイムに提供し、ユーザーが次のことを行うのに役立ちます。

• 関連領域へすばやく知識を広げる
• 同じ質問に対するさまざまな視点を探索する
• 複雑なトピックの具体的な側面を掘り下げる

ライセンス

MIT ライセンス

貢献

貢献を歓迎します。お気軽にプルリクエストをお送りください。

サポート

サポートについては、[email protected] までお問い合わせいただくか、GitHub でイシューを作成してください。