Hika MCP Server

🚀 Hika MCP Server

Hika MCP Server is an implementation of Server-Sent Events (SSE) designed for the Hika AI knowledge search tool. This server component enhances the search experience through real-time streaming, offering AI-generated perspectives and knowledge expansion.

Hika AI is a knowledge search engine that leverages AI to analyze search queries from multiple cognitive perspectives (MCP), helping users broaden their horizons, explore related fields, or delve into various aspects of specific issues.

✨ Features

• Real-time streaming of AI-generated content via the SSE protocol.
• Provision of multiple cognitive perspectives to enhance knowledge exploration.
• Support for JWT Bearer token authentication.
• Easy integration with the Hika AI ecosystem.

📦 Prerequisites

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

📦 Installation

# Clone the repository
git clone https://github.com/hikaai/mcp-server.git
cd mcp-server

# Install dependencies
npm install

# Set environment variables
cp .env.example .env
# Edit the .env file with your credentials

📚 Configuration

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 the application:

{
  "command": "",
  "url": "https://hika.fyi/api/mcp/sse",
  "env": {
    "HIKA_AUTH": "Bearer your_jwt_token_here"
  }
}

💻 Usage Examples

Basic Usage

Start the server

npm start

Client connection example

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

📚 Documentation

API Reference

SSE Endpoint

GET /api/mcp/sse

Request Headers

• Authorization: Bearer token for authentication.

Event Types

The server emits the following event types:

1. perspective - New AI-generated perspectives for the search query.
2. knowledge_extension - Expansion of related knowledge areas.
3. deep_dive - In-depth analysis of specific aspects.
4. completion - Indicates the end of the stream.

Event Data Format

{
  "type": "perspective",
  "content": {
    "title": "Historical background",
    "description": "Viewing the issue from a historical perspective...",
    "relevance_score": 0.85
  }
}

Authentication

The server uses JWT Bearer tokens for authentication. The token should be included in the Authorization request header:

Authorization: Bearer eyJhbGciOiJFUzM4NCIsInR5cCI6ImF0K2p3dCIs...

Error Handling

The server may return the following error codes:

• 401 - Unauthorized (invalid or expired token).
• 429 - Too many requests (rate limit).
• 500 - Internal server error.

Important Notes

• Ensure the server runs on an allowed port.
• When configuring environment variables, ensure all values are correct.
• In a production environment, it is recommended to enable error handling and logging.

By following the above steps, you can easily set up and use the Hika MCP Server to enhance your knowledge search experience.