@hpbyte/h-codex-mcp

Model Context Protocol server for h-codex, providing AI assistants with tools to interact with code indexing and search functionality.

✨ Features

• Multiple Projects Support: Index and search multiple projects
• Semantic Search: Find relevant code snippets using natural language queries
• Code Indexing: Index repositories for semantic code search
• AI Assistant Integration: Seamlessly works with AI assistants that support MCP
• Simple Setup: Easy configuration with common AI coding tools

🚀 Getting started

h-codex MCP server can be integrated with various AI assistants that support the Model Context Protocol:

Claude Desktop

{
  "mcpServers": {
    "h-codex": {
      "command": "npx",
      "args": ["@hpbyte/h-codex-mcp"],
      "env": {
        "LLM_API_KEY": "your_llm_api_key_here",
        "LLM_BASE_URL": "your_llm_base_url_here (default is openai baseurl: https://api.openai.com/v1)",
        "DB_CONNECTION_STRING": "postgresql://postgres:password@localhost:5432/h-codex"
      }
    }
  }
}

Cursor

1. Navigate to Settings → MCP Servers → Add Server
2. Fill in the server details:
   • Name: h-codex
   • Type: STDIO
   • Command: npx
   • Arguments: ["@hpbyte/h-codex-mcp"]
   • Environment Variables: _ LLM_API_KEY: your-llm-api-key _ LLM_BASE_URL: your_llm_base_url_here (default is openai baseurl: https://api.openai.com/v1) _ And any additional database configuration variables

Other MCP Clients

The server uses stdio transport and follows the standard MCP protocol. It can be integrated with any MCP-compatible client.

🛠️ Available Tools

| Tool Name | Description | Parameters | | ------------- | ------------------------------------------ | ----------------------------------------------- | | code-clear | Clear the indexed information of project | project: String - The project to clear index | | code-search | Semantically search through indexed code | query: String - The search query text | | code-index | Index a directory/repository for searching | path: String - Path to the directory to index |

Example Usage

With Claude or other AI assistants, you can use these tools like:

Please search the codebase for "database connection implementation"

Or:

Please index the src directory for me

🧑‍💻 Development

Getting Started

# Clone repository
git clone https://github.com/hpbyte/h-codex.git
cd h-codex

# Install dependencies
pnpm install

# Start development server with hot reload
pnpm --filter @hpbyte/h-codex-mcp dev

Building

# Build for production
pnpm --filter @hpbyte/h-codex-mcp build

🔮 Upcoming Features

• [ ] Enhanced code analysis tools
• [ ] Dependency graph analysis

📄 License

This project is licensed under the MIT License.