实时知识搜索服务器

Hika MCP Server是一个基于Server-Sent Events (SSE)的实时知识搜索服务器,为Hika AI知识搜索工具提供实时流式传输AI生成的视角和知识扩展,增强搜索体验。

  • by atlas-comstock
  • 本地部署
  • 更新于
在 GitHub 查看 atlas-comstock/hika-mcp-server

使用说明

Hika MCP服务器

概述

Hika MCP Server是Hika AI知识搜索工具的服务器发送事件(SSE)实现。该服务器组件有助于实时流式传输人工智能生成的视角和知识扩展,以增强搜索体验。

Hika AI是一种知识搜索工具,它使用人工智能为搜索查询提供多种认知视角(MCP),通过探索相关知识领域或深入探究问题的特定方面来帮助用户拓宽理解。

特性

  • 通过SSE协议实时流式传输AI生成的内容
  • 多元认知视角促进知识探索
  • 通过JWT承载令牌进行身份验证
  • 轻松与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:用于身份验证的承载令牌

事件

服务器发出以下事件类型:

  1. perspective -人工智能生成的搜索查询新视角
  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承载令牌进行身份验证。代币应包含在 Authorization 标题如下:

Authorization: Bearer eyJhbGciOiJFUzM4NCIsInR5cCI6ImF0K2p3dCIs...

错误处理

服务器可能会返回以下错误代码:

  • 401 -未经授权(令牌无效或过期)
  • 429 -请求太多(超过速率限制)
  • 500 -内部服务器错误

发展

以开发模式运行

npm run dev

运行测试

npm test

与Hika AI集成

该服务器组件旨在与Hika AI知识搜索工具无缝协作。集成后,它提供实时AI生成的视角,帮助用户:

  • 快速将他们的知识扩展到相关领域
  • 探索同一问题的不同观点
  • 深入探讨复杂主题的具体方面

许可证

MIT许可证

贡献

欢迎投稿!请随时提交拉取请求。

支持

如需支持,请联系support@hika.fyi或者在GitHub上发布一个问题。