honu-mcp by honu-ai - MCP Server

MCP Spike

MCP Server Local Installation Guide

This guide walks you through installing and configuring the MCP server locally for use with Claude Desktop.

Prerequisites

Git
Python 3.8+

Step 1: Install Poetry

First, check if Poetry is already installed:

which poetry

If no path is returned, install Poetry using the official installer:

curl -sSL https://install.python-poetry.org | python3 -

For additional installation options, see the Poetry documentation.

Step 2: Clone the Required Repositories

Clone the greensea repository:

cd ~
git clone https://github.com/honu-ai/greensea.git

Clone the MCP spike repository:

cd ~
git clone https://github.com/honu-ai/mcp-spike.git
cd mcp-spike

Make note of both repository paths:
```
echo $PWD
```
Update the dependency path in pyproject.toml:

Open the pyproject.toml file in the mcp-spike directory and replace the path to the hap_adk dependency:
```
hap_adk = {path = "<path to your greensea repo>/greensea/src/hap_adk"}
```
Update dependencies:
```
poetry update
```

Step 3: Configure the MCP Server

Find your Poetry executable path:
```
which poetry
```
Obtain your Honu token:
- Open HAP (Honu Application Platform)
- Navigate to any model
- Open the inspector and copy the token from any request

Create the configuration file:

Create or edit the file at:

/Users/<your username>/Library/Application Support/Claude/claude_desktop_config.json

Add the following configuration:

{
    "mcpServers": {
        "ping": {
            "command": "<path to poetry>",
            "args": [
                "run",
                "-C",
                "<path to repo>",
                "python",
                "<path to repo>/src/main.py"
            ],
            "env": {
                "HONU_TOKEN": "<honu_token>",
                "HONU_PLATFORM_URL": "https://happi.honutech.ai"
            }
        }
    }
}

Replace the placeholders:

<path to poetry> with the result from which poetry
<path to repo> with the full path to your cloned mcp-spike repository
<honu_token> with your actual Honu token

Step 4: Verify Installation

Restart the Claude Desktop application to apply the changes. You can verify that everything is working properly by checking Claude's ability to connect to your local MCP server.