thimble (Inovacc)

英语 | 葡萄牙语 | 西班牙语

顶针

用于AI编码助手的单个二进制MCP插件。提供FTS5知识库、多语言代码执行、会话持久性和安全实施——所有这些都是进程内的，不需要守护进程。

特性

• MCP服务器 -具有46个原生工具的stdio传输+~80个GitHub API工具+动态插件（执行、搜索、索引、获取、分析、批处理、委派、报告、git、gh、lint、目标、工作空间、共享知识）
• 单一二进制 --每个实例都是独立的；没有守护进程，没有gRPC，没有发现链
• FTS5知识库 --BM25排名搜索，具有5层回退（波特、三元组、模糊、嵌入、TF-IDF）
• 多边形执行器 --11种语言（shell、Python、JS/TS、Go、Rust、Ruby、PHP、Perl、R、Elixir）
• 代码分析 --8个解析器（Go、Python、Rust、TypeScript、Protobuf、Shell、C、Java）、符号提取、跨语言调用图
• Git集成 --13个git MCP工具（状态、差异、日志、责备、分支、隐藏、提交、更改日志、合并、重基、冲突、validate_branch、lint_mit）+git感知安全策略
• GitHub 集成 -8 gh CLI子流程工具（包括PR模板）+~80通过GitHub-mcp-server导入的GitHub API工具
• Lint集成 --golangci lint v2通过子流程（需要 golangci-lint PATH），自动修复支持
• 插件市场 --从安装社区插件 注册表 (thimble plugin install docker)，或从任何URL/GGitHub路径。基于JSON的工具定义，带有模板命令替换。
• 会话保持 --按项目事件跟踪、简历快照、优先级预算上下文
• 安全 --Bash策略执行、文件路径拒绝globs、shell转义检测、git/gh危险命令阻止
• 9个IDE适配器 --Claude Code、Gemini CLI、VS代码副本、游标、OpenCode、Codex、Kiro、OpenClaw、反重力
• 自动报告 --AI消耗品降价中的医生和统计报告
• OpenTetry跟踪 --跨MCP工具调用的分布式跟踪

安装

步骤1——安装：

# Linux / macOS
curl -fsSL https://raw.githubusercontent.com/inovacc/thimble/main/scripts/install.sh | bash

# Windows (PowerShell)
irm https://raw.githubusercontent.com/inovacc/thimble/main/scripts/install.ps1 | iex

步骤2——选择您的IDE：

thimble setup

这显示了一个交互式菜单，用于选择您的AI编码助手（Claude Code、Gemini CLI、Cursor等）并自动配置所有内容。

Other install methods

去安装：

go install github.com/inovacc/thimble/cmd/thimble@latest

npm（GitHub包）：

echo @inovacc:registry=https://npm.pkg.github.com >> ~/.npmrc
npm install -g @inovacc/thimble

预构建二进制文件： 发布

可选外部工具： golangci-lint （用于棉绒工具）和 gh 如果要使用这些功能，必须单独安装CLI（用于gh工具）。如果未在PATH中找到，则两者都会优雅地降级。

快速开始

1.为IDE配置挂钩

# Plugin mode (Claude Code — recommended)
claude --plugin-dir ~/.thimble/plugin

# Or manual setup for other IDEs
thimble setup --client gemini
thimble setup --client cursor

2.用作MCP服务器（默认）

# Runs MCP server on stdio (used by IDE hook config)
thimble

3.诊断

thimble doctor              # Run diagnostic checks
thimble hooklog             # View hook interaction logs
thimble hooklog --blocked   # Show only blocked hooks

命令

MCP工具

原生工具（46）

GitHub API工具（~80）

进口自 github-mcp-server v0.3.0--涵盖问题、PR、repo、操作、代码扫描、Dependabot、讨论、注册表、项目、通知、标签、安全建议、星号、用户/团队和Copilot。需要 GITHUB_PERSONAL_ACCESS_TOKEN.

动态插件工具

从安装社区插件 插件注册表 或任何URL:

# Browse available plugins
thimble plugin search

# Install from registry (by name)
thimble plugin install docker
thimble plugin install kubernetes
thimble plugin install terraform

# Install from GitHub
thimble plugin install github.com/user/repo/my-plugin.json

# Install from URL
thimble plugin install https://example.com/plugin.json

# Manage
thimble plugin list              # show installed
thimble plugin update            # update all from registry
thimble plugin update docker     # update specific plugin
thimble plugin remove docker     # uninstall

可用的注册表插件：

创建自己的插件 --看看 插件创作指南.

发展

task build    # Build binary
task test     # Run tests
task lint     # golangci-lint
task release  # GoReleaser (requires git tag)

建筑

thimble (single binary)
  |
  |-- MCP Bridge (stdio) ---- ContentStore (FTS5/SQLite)
  |   (46 native + ~80 GH)    SessionDB (events, snapshots)
  |                            PolyglotExecutor (11 langs)
  |-- Hook Dispatcher -------- Security Engine (policies)
  |   (PreToolUse/PostToolUse) CodeAnalysis (8 parsers)
  |                            TaskDelegate (background)
  |-- CLI Commands ----------- GitOps (13 operations)
  |   (lint, hooklog, doctor)  GhCli (subprocess)
  |                            Linter (subprocess)
  |-- Plugin System ---------- Report Engine
      (hot-reload, registry)   OTel Tracing

许可证

BSD 3-条款