tamsaek (Indosaram)

坦萨克

具有全文功能的本地文件搜索引擎。建于 坦提维 为了快速搜索。既可作为 MCP服务器 以及一个独立的 CLI工具.

特性

• 全文检索：由Tantivy提供短语、布尔运算符和特定字段查询
• 正则表达式搜索：使用正则表达式查找模式（术语级）
• 元数据筛选：按文件扩展名、源类型筛选
• 增量索引：添加文档而不重建索引
• 零外部依赖：不需要单独的数据库或搜索服务器
• 共享索引：CLI和MCP服务器共享同一索引——索引一次，从任何地方搜索
• 符合MCP标准：正确的错误处理、工具注释

安装

源自源头

git clone https://github.com/Indosaram/tamsaek.git
cd tamsaek
cargo build --release

二进制：

• target/release/tamsaek-mcp --MCP服务器
• target/release/tamsaek --CLI工具

使用货物

# MCP server
cargo install tamsaek-mcp

# CLI tool
cargo install tamsaek-cli

______________________________________________________________________

CLI使用情况

全局选项

______________________________________________________________________

tamsaek index --为目录建立索引

递归扫描目录并将文件添加到搜索索引中。

# Index all files in a directory
tamsaek index /path/to/project

# Index only specific extensions
tamsaek index /path/to/project -e rs,toml,md

# Non-recursive indexing (current directory only)
tamsaek index /path/to/project --recursive false

______________________________________________________________________

tamsaek search --全文搜索

使用自然语言查询在索引文档中搜索。

tamsaek search "error handling"
tamsaek search "TamsaekIndex" --limit 5

输出示例：

Found 4 results for 'TamsaekIndex':
[1] /path/to/lib.rs (Score: 3.42)
  ID: /path/to/lib.rs
  Snippet: use tamsaek_core::{TamsaekIndex, Document};

______________________________________________________________________

tamsaek search-regex --正则表达式搜索

使用正则表达式模式搜索文档。Regex在 学期水平 （单个单词），而不是整行。

tamsaek search-regex "tamsaek.*"
tamsaek search-regex "inde[x]" --limit 3

备注：Tantivy正则表达式匹配单个标记化术语。多单词模式，如 fn.*open 不会跨越令牌边界匹配。使用以下模式 doc.*ment （在一个单词内）。

______________________________________________________________________

tamsaek filter --筛选文档

按文件扩展名或源类型筛选索引文档。

# List all .rs files
tamsaek filter --extension rs

# Filter by source
tamsaek filter --source local --limit 20

# Combine filters
tamsaek filter --extension md --source local

______________________________________________________________________

tamsaek get-document --检索文档

通过ID（通常是文件路径）从索引中获取特定文档。

# Preview (truncated to 500 chars)
tamsaek get-document "/path/to/file.rs"

# Full content
tamsaek get-document "/path/to/file.rs" --full

______________________________________________________________________

tamsaek stats --指数统计

显示有关当前索引的信息。

tamsaek stats

输出示例：

Index Statistics:
  Path: /Users/you/Library/Application Support/tamsaek/index
  Documents: 27

______________________________________________________________________

tamsaek remove --删除文档

按ID从索引中删除单个文档。

tamsaek remove "/path/to/old-file.rs"

______________________________________________________________________

tamsaek clear --清除索引

移除 全部 索引中的文档。提示确认，除非 --force 使用。

# With confirmation prompt
tamsaek clear

# Skip confirmation
tamsaek clear --force

______________________________________________________________________

MCP服务器使用情况

使用Claude Desktop进行设置

添加 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "tamsaek": {
      "command": "/path/to/tamsaek-mcp"
    }
  }
}

可用的MCP工具

MCP工具示例

搜索：

{
  "query": "rust programming",
  "limit": 20
}

索引目录：

{
  "path": "/path/to/documents",
  "extensions": ["txt", "md", "rs"],
  "recursive": true
}

______________________________________________________________________

建筑

tamsaek/
├── crates/
│   ├── tamsaek-core/   # Search engine library (shared)
│   ├── tamsaek-mcp/    # MCP server binary
│   └── tamsaek-cli/    # CLI tool binary

tamsaek-core 提供由MCP服务器和CLI共享的索引和搜索引擎。这意味着他们在 同一指数 --通过CLI索引的文档可以从MCP服务器立即搜索，反之亦然。

配置

索引位置

按平台列出的默认索引目录：

用覆盖 --index-path 标志：

tamsaek --index-path /custom/path search "query"

发展

# Check compilation
cargo check

# Run tests (includes integration tests for CLI)
cargo test

# Run with logging
RUST_LOG=info cargo run -p tamsaek-mcp

# Build release
cargo build --release

许可证

MIT许可证-请参阅 许可证