Hika MCP 服务器

概述

Hika MCP 服务器是 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 身份验证凭据

安装

# 克隆存储库
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('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": "历史背景",
    "description": "从历史角度看待这个问题...",
    "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。

支持

如需支持，请联系 support@hika.fyi 或在 GitHub 上打开一个 issue。