ts-index

一个强大的TypeScript代码索引和搜索工具，支持语言服务器协议（LSP）和模型上下文协议（MCP）集成。

主要特性

• 语义搜索：使用嵌入式查询进行高级代码搜索
• 符号搜索：精确匹配和查找符号名称
• LSP集成：支持TypeScript分析的语言服务器协议
• MCP服务器：通过模型上下文协议提供索引和搜索能力
• 向量数据库：基于SQLite的存储，具有向量搜索能力
• 多种传输方式：支持stdio、HTTP和SSE通信协议

技术栈

• TypeScript解析器：tree-sitter-typescript - 适用于tree-sitter的TypeScript和TSX语法
• 语言服务器：yioneko/vtsls / typescript-language-server - TypeScript的LSP封装
• 向量数据库：asg017/sqlite-vec - SQLite的向量搜索扩展

使用方法

索引一个TypeScript项目

ts-index index --project /path/to/project --db /path/to/index.db

语义搜索代码

ts-index search "function to parse JSON" --project /path/to/project --db /path/to/index.db

按精确符号名称搜索

ts-index search "parseJSON" --symbol --db /path/to/index.db

语言服务器协议命令

# 分析位置处的符号
ts-index lsp analyze src/utils.ts --project /path/to/project --line 10 --character 5

# 获取代码补全
ts-index lsp completion src/utils.ts --project /path/to/project --line 10 --character 5

# 搜索工作区符号
ts-index lsp symbols --project /path/to/project --query "parse"

# 安装语言服务器
ts-index lsp install vtsls

# 检查LSP健康状态
ts-index lsp health

运行MCP服务器

# stdio模式（默认）
ts-index mcp --project /path/to/project --db /path/to/index.db

# HTTP模式
ts-index mcp --transport http --address :8080 --db /path/to/index.db

# SSE模式
ts-index mcp --transport sse --address :8080 --db /path/to/index.db

开发

命令

# 运行linter
make lint

# 运行带有自动修复的linter
make lint-fix

# 运行测试
make test

构建

go build -o bin/ts-index ./cmd/ts-index