🚀 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 服务器来增强知识搜索体验。