Baike.dev
All toolsOnline toolsAI codingTrendingOpen sourceNewsSubmit
Log in
< Back to tools
H

hitmux-context-engine

> 编程语言
Open source

Semantic code search and context engine for AI coding agents.

399 stars0 likes1 views
WebsiteGitHub

About

Semantic code search and context engine for AI coding agents.

Hitmux Context Engine

Language: English | 中文 | Español | Français | Deutsch | 日本語 | 한국어

Semantic context search for MCP clients.

Hitmux Context Engine indexes a local directory into Milvus-compatible vector storage, then gives Claude Code, OpenAI Codex CLI, OpenCode, Cursor, Windsurf, and other MCP clients focused tools for finding relevant code, docs, notes, config, and other indexed context. Use it when an AI agent needs more than text grep:

  • Search indexed context with natural-language, filename, heading, or identifier-heavy queries.
  • Search all indexed content by default, or narrow to docs-only or code-only context.
  • Keep project configuration in simple config.conf files instead of per-client environment setup.

Typical first-use workflow:

hce index .
Check the indexing status
Find the handler that validates MCP tool arguments

Quick Start

Create or complete the runtime config:

bash
npm install -g @hitmux/hce@latest
hce init

Then edit ~/.hitmux-context-engine/config.conf and fill in the provider key. Check local config and connectivity:

bash
hce doctor

For Claude Code, add the MCP server:

bash
claude mcp add hitmux-context-engine -- hce

For OpenAI Codex CLI, add the MCP server:

bash
codex mcp add hitmux-context-engine -- hce

The @hitmux/hce CLI package and the original MCP package @hitmux/hitmux-context-engine-mcp start the same server.

Database note: Use Local Milvus with milvusAddress = localhost:19530. For self-hosted remote Milvus, replace it with the reachable host and port, and add milvusToken only if authentication is required. For a free Zilliz Cloud database, sign up at https://cloud.zilliz.com/signup, then use the cloud public endpoint and add milvusToken with your Personal Key. Other database backends are not selectable from config.conf.

For a new repository, create the first index from the repository root before relying on MCP search:

bash
hce index .

Then open your MCP client in the repository and ask:

Check the indexing status
Find functions that handle user authentication

You can also check status from a shell:

bash
hce status .

CLI Usage

hce with no arguments starts the MCP stdio server for clients. Use arguments when running it directly from a shell:

Task Command
Show help or version hce --help, hce --version
Create or complete global config hce init
Show global and project config paths hce config path
Check config and connectivity hce doctor, hce doctor --no-connectivity
Index the current directory hce index .
Show index status hce status ., hce status . --refresh
Search indexed context from shell hce search "query" . --limit 5 --scope all
Manage indexes and collections hce list, hce list , hce clear , hce repair , hce rm , hce index --force

More client examples, including Cursor, Windsurf, Claude Desktop, Gemini CLI, Qwen Code, VS Code MCP, Cline, and Roo Code, are in docs/quick-start.md.

For a local source checkout, run ./scripts/install-local-global.sh to build the workspace and install a user-level hitmux-context-engine-mcp command from the current checkout. Run the script with sudo to install the command globally. Published-package Claude Code and Codex CLI setup uses the global hce command shown above.

Configuration

Hitmux Context Engine reads product configuration from conf files:

  1. ~/.hitmux-context-engine/config.conf
  2. ./.hitmux-context-engine/config.conf
  3. built-in defaults

Project config overrides global config for fields that are present. Environment variables and ~/.hitmux-context-engine/.env are not used for MCP product options.

See docs/configuration.md for provider, Milvus/Zilliz, indexing, sync, and file filtering options.

Packages

  • @hitmux/hitmux-context-engine-mcp: MCP stdio server for Claude Code and other MCP clients.
  • @hitmux/hce: npm package alias for the MCP server.
  • @hitmux/hitmux-context-engine-core: TypeScript indexing, splitting, embedding, synchronization, and vector database package.

See docs/package-reference.md for tools, package usage, and core API examples.

Repository Layout

packages/core     Core indexing engine
packages/mcp      MCP server
docs              Flat documentation
examples          Local usage examples
evaluation        Evaluation scripts and raw case-study data
python            Python bridge helpers

Development

Use Node >=20 and pnpm >=10.

bash
pnpm install
pnpm build
pnpm typecheck
pnpm lint
pnpm --filter @hitmux/hitmux-context-engine-core test
pnpm --filter @hitmux/hitmux-context-engine-mcp test

Package-specific commands:

bash
pnpm build:core
pnpm build:mcp
pnpm build:examples
pnpm dev
pnpm example:basic

Before opening a PR, describe the changed package, behavior, validation commands, and any configuration or migration notes.

Documentation

  • docs/configuration.md: canonical conf configuration reference.
  • docs/quick-start.md: MCP client setup.
  • docs/troubleshooting.md: common setup and runtime problems.
  • docs/package-reference.md: MCP tools and core package usage.

License

MIT. See LICENSE.

Acknowledgements

This project is based on the core of zilliztech/claude-context. Thanks to the Linux Do community for its support.

Screenshots

Issues· 0 open

View all issuesOpen on GitHub

No open issues yet, or sync has not completed.

> Tags

TypeScript

No comments yet. Be the first to share.

> Details

PublishedAug 1, 2026
UpdatedSep 17, 2026
Category编程语言
PricingOpen source

> Related tools

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言