Hika MCP Server is a Server-Sent Events (SSE) implementation for the Hika AI knowledge search tool. This server component facilitates real-time streaming of AI-generated perspectives and knowledge extensions to enhance the search experience.

Hika AI is a knowledge search tool that uses artificial intelligence to provide multiple cognitive perspectives (MCP) on search queries, helping users to broaden their understanding by exploring related knowledge domains or diving deeper into specific aspects of their questions.

• Real-time streaming of AI-generated content via SSE protocol
• Multiple cognitive perspectives to enhance knowledge exploration
• Authentication via JWT Bearer tokens
• Easy integration with the Hika AI ecosystem

• Node.js (v14.0.0 or higher)
• Understanding of Server-Sent Events (SSE)
• Valid Hika AI authentication credentials

# 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

Set the following environment variables:

PORT=3000
HIKA_API_URL=https://api.hika.fyi
JWT_SECRET=your_jwt_secret

Or use the provided configuration in your application:

{
  "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();
};

GET /api/mcp/sse

• Authorization: Bearer token for authentication

The server emits the following event types:

1. perspective - New AI-generated perspective on the search query
2. knowledge_extension - Additional related knowledge domain
3. deep_dive - In-depth analysis of a specific aspect
4. completion - Signals the end of the stream

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

The server uses JWT Bearer tokens for authentication. Tokens should be included in the Authorization header as follows:

Authorization: Bearer eyJhbGciOiJFUzM4NCIsInR5cCI6ImF0K2p3dCIs...

The server may return the following error codes:

• 401 - Unauthorized (invalid or expired token)
• 429 - Too Many Requests (rate limit exceeded)
• 500 - Internal Server Error

npm run dev

npm test

This server component is designed to work seamlessly with the Hika AI knowledge search tool. When integrated, it provides real-time AI-generated perspectives that help users:

• Quickly extend their knowledge into related domains
• Explore different viewpoints on the same question
• Dive deeper into specific aspects of complex topics

MIT License

Contributions are welcome! Please feel free to submit a Pull Request.

For support, please contact support@hika.fyi or open an issue on GitHub.