Server Hika

Hika MCP 服务

概述

Hika MCP 服务是 Hika AI 知识搜索工具的服务器发送事件（SSE）实现。该服务端组件可实时流式传输 AI 生成的观点和知识扩展，提升搜索体验。

Hika AI 是一款知识搜索工具，利用人工智能针对搜索查询提供多种认知视角（MCP），帮助用户通过探索相关知识领域或深入了解问题的特定方面来拓宽认知。

功能

• 通过 SSE 协议实时流式传输 AI 生成的内容
• 提供多种认知视角，助力知识探索
• 通过 JWT Bearer 令牌进行身份验证
• 轻松集成到 Hika AI 生态系统

前置条件

• Node.js（v14.0.0 或更高版本）
• 了解服务器发送事件（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 许可证

贡献

欢迎贡献！欢迎提交 Pull Request。

支持

如需支持，请联系 [email protected]，或在 GitHub 上提交 issue。