open-index/open-npm huggingface dataset:
npm package: @hayeah/html2md
Description: To install dependencies:
Latest version: 1.0.2

# html2md

To install dependencies:

```bash
bun install
```

To run:

```bash
bun run index.ts
```

This project was created using `bun init` in bun v1.1.38. [Bun](https://bun.sh) is a fast all-in-one JavaScript runtime.
npm package: @hayhandsome/code-index-mcp
Description: MCP server for code indexing and semantic search
Latest version: 0.1.3

# code-index-mcp

一个可通过 `npx` 运行的 MCP 服务器，为 AI 工具提供代码索引与语义搜索能力。每次调用会执行按需增量同步，保证结果最新。

## 运行要求

- Node.js >= 18
- Qdrant（默认 `http://localhost:6333`）

## 快速开始

```bash
npx @hayhandsome/code-index-mcp
```

默认使用 stdio 传输，适配 MCP 客户端的子进程方式调用。

## 配置

### 全局配置（推荐）

目录：`~/.code-index-mcp/`

`config.json`（非敏感）：
```json
{
  "qdrantUrl": "http://localhost:6333",
  "embedderProvider": "openai",
  "modelId": "text-embedding-3-small",
  "modelDimension": 1536,
  "embeddingBatchSize": 60,
  "searchMinScore": 0.2,
  "searchMaxResults": 20,
  "timeoutMs": 300000,
  "openAiCompatibleBaseUrl": "http://localhost:1234",
  "ollamaBaseUrl": "http://localhost:11434"
}
```

`secrets.json`（敏感）：
```json
{
  "qdrantApiKey": "",
  "openAiApiKey": "",
  "openAiCompatibleApiKey": ""
}
```

### Workspace 覆盖（可选）

目录：`<workspace>/.code-index/`

`config.json` / `secrets.json` 会覆盖全局配置。

### 环境变量（最高优先级）

- `CODE_INDEX_QDRANT_URL`
- `CODE_INDEX_QDRANT_API_KEY`
- `CODE_INDEX_EMBEDDER_PROVIDER`
- `CODE_INDEX_MODEL_ID`
- `CODE_INDEX_MODEL_DIMENSION`
- `CODE_INDEX_EMBEDDING_BATCH_SIZE`
- `CODE_INDEX_SEARCH_MIN_SCORE`
- `CODE_INDEX_SEARCH_MAX_RESULTS`
- `CODE_INDEX_TIMEOUT_MS`
- `CODE_INDEX_OPENAI_API_KEY`
- `CODE_INDEX_OPENAI_COMPATIBLE_API_KEY`
- `CODE_INDEX_OPENAI_COMPATIBLE_BASE_URL`
- `CODE_INDEX_OLLAMA_BASE_URL`

## MCP 工具

- `code_index_search`：按需同步后搜索
- `code_index_update`：执行一次增量同步
- `code_index_reindex`：清空并重建索引
- `code_index_clear`：清空向量与本地缓存
- `code_index_status`：查看当前配置与索引状态

### 示例：搜索

```json
{
  "tool": "code_index_search",
  "arguments": {
    "query": "How is the config loaded?",
    "workspacePath": "/path/to/repo"
  }
}
```

## 忽略规则

- 自动读取 `.gitignore`
- 如果存在 `.rooignore`，会在 `.gitignore` 基础上叠加

## 许可

MIT