Carrick

io.github.carrick-tools由 GitHub 账号 carrick-tools 发布v0.4.0更新于 Nov 9, 2026

TypeScript codebase intelligence for AI agents and IDEs, across every service and repo.

已验证Streamable HTTP可网页运行云端与基础设施知识与记忆开发者工具

概览

AI 生成的概览

远程 MCP 服务器，为 TypeScript 代码库建立跨服务、跨仓库索引，让助手按意图搜索函数并查看端点、类型与调用方。

可以做什么
  • 按意图、相似度或服务/文件分页浏览已索引的函数
  • 查看服务、项目与跨服务调用图，包括未匹配调用
  • 查询操作、调用方、API 端点及编译器解析出的请求/响应类型
  • 检查消费方与生产方的兼容性并逐项对比契约
  • 读取 npm 依赖与版本冲突，列出对外部目标的出站调用
  • 生成 Carrick 配置文件，如工作流、技能与配置脚手架
适用场景
适合在全栈或多服务 TypeScript 代码库中工作的助手：需要找到已有实现、在改动端点前确认谁在调用，或核对前端调用是否仍与后端处理程序一致时使用。
运行要求
远程端点 api.carrick.tools，需通过 OAuth 登录。索引本身由 Carrick CLI 构建（npm install -g carrick、carrick init，需 Node 24 或更高版本），或在 CI 中通过 GitHub Action 刷新；README 提到提供免费方案。
安装前请注意
登录后该服务可访问你的代码索引，索引中的代码元数据会发送到 Carrick 服务器。scaffold 工具会向项目写入配置文件，carrick init 会向 .claude/skills 与 .agents/skills 安装技能。免费方案之外的配额与价格此处未说明。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Carrick，将其添加到工作区。
  2. 连接 所需的 凭据。它们会被私密存储，绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.carrick-tools%2Fcarrick/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。 客户端会在首次连接时完成 OAuth 登录。

{
  "mcpServers": {
    "carrick": {
      "type": "http",
      "url": "https://api.carrick.tools/mcp"
    }
  }
}

README

[Carrick]

Carrick

TypeScript codebase intelligence for AI agents & IDEs.

[Listed on mcpservers.org] [GitHub Marketplace] [Carrick MCP connector – tool definition quality and endpoint health on Glama] [Claude directory] [npm] [Open VSX] [MCP Registry]

Coding agents working across full-stack and multi-service codebases routinely rebuild existing helpers, trust stale type definitions, and modify API contracts without knowing who consumes them.

Carrick solves this by indexing your entire TypeScript ecosystem, from frontend apps to backend services, whether they live in a monorepo or across multiple repositories. By integrating deeply with the TypeScript compiler, Carrick traces every route, type, and cross-service call while recording function behaviour—so agents search by intent rather than name and stay grounded in your real architecture.

Delivered via MCP for AI agents and LSP for IDEs, Carrick ensures models see existing endpoints and utilities before generating new code. The scanner is source-available, runs from your CLI or CI pipeline, and includes a Free plan so you can start building safer agent workflows immediately.

Get started

bash
npm install -g carrickcarrick init

carrick init signs you in, connects your agent and downloads your index. The quick start has the details (Node 24 or newer).

One index, three surfaces

Search existing code through your agent, inspect live contracts in your editor, and catch breaking changes in your pull requests.

In your agent

Give your AI assistants complete context on what already exists, how endpoints are shaped, and who breaks if something changes. Carrick maps every function by what it actually does, allowing agents to find existing implementations and build on them—even in repositories you haven't checked out locally. Endpoint types are pulled straight from the TypeScript compiler in the service that exposes them.

Works with any MCP-compatible agent, including Claude Code, Cursor, Windsurf, and Codex.

In your editor

Inspect cross-service contracts and jump between connected files without leaving your IDE. "Go to Definition" jumps directly from a service call to its handler when the code is on disk, while Code Lens displays every caller across your local index inline. If a frontend call and backend handler fall out of sync, Carrick surfaces type mismatches as native editor diagnostics.

Available on the Visual Studio Marketplace and Open VSX, or runnable as a standard LSP server.

In your pull request

Bring the exact same index into CI to catch contract risks, duplicate work, and silent version drift. When a producer and consumer fall out of sync—regardless of protocol—Carrick flags the exact mismatch directly on your PR before it merges. It also checks dependency versions across services to catch conflicting package updates early.

Skills

Carrick ships with four skills for the most common agent failures — breaking a caller in another service, rebuilding existing code, trusting a stale copy of another service's type, and missing places in a codebase-wide change. Each skill gets its answer from the Carrick index. carrick init installs them into .claude/skills/ and .agents/skills/.

SkillUse itWhat it returns
carrick-impactBefore changing or deleting a route, handler, response shape, event or shared function, or to ask "who calls this?"Everything that depends on the code you are about to change, with a file and line for each, and a type verdict for each consumer
carrick-reuseAt the end of a task that added or changed functions, or to ask "does this already exist?"The new functions compared against the whole function index, and the places the project has built the same thing twice
carrick-driftBefore changing a request or response type, or when a compatibility verdict names a problem you cannot placeThe producer's type, each consumer call site's expected type and the stored verdict, side by side, one operation at a time
carrick-censusFor "find every place that does X" questionsEvery match for two wordings of one concept, paged to the end and joined into one list with a receipt

Ask your agent

  • "Which functions handle webhook signing across our services?"
  • "Where do we deduplicate users by email?"
  • "What calls /api/users, and what response shape does each caller expect?"
  • "Show me every function that retries on rate-limit errors."

MCP tools

The MCP endpoint exposes the index as structured tools your agent can call directly. The MCP tools reference lists each tool's parameters and response.

ToolPurpose
search_by_intentSearch functions by what they do, matching a plain-English query against each function's intent
find_similarFind similar functions, for code you are about to write or duplicates already in the project
list_function_intentsBrowse indexed functions and intents, a page at a time, by service or file
get_project_mapShow the project map, a short summary of services, contracts and unmatched calls
list_projectsList workspace projects and the repositories connected to each
list_servicesList the project's services, with their endpoint, call and function counts
get_service_graphShow the cross-service call graph, with unmatched calls and orphaned endpoints
get_operationFind who serves and calls an operation, given its method and path
get_callersFind callers of a function anywhere in the project
get_api_endpointsList a service's operations across HTTP, GraphQL, WebSockets and pub/sub
get_endpoint_typesRead an endpoint's request and response types as the TypeScript compiler resolved them
get_type_definitionResolve a named type definition to its expanded TypeScript
check_compatibilityCheck a consumer against a producer, with a type verdict for each call
get_service_dependenciesRead npm dependencies and version conflicts, for one service or across the project
list_external_callsList outbound calls to external targets, such as SDK calls, external domains and env-var URLs
get_contract_pairCompare consumer and producer types, operation by operation
scaffoldGenerate Carrick setup files (the workflow, a Carrick skill, carrick.json and Claude Code hooks)

Keep the index current

The GitHub Action refreshes each repository's part of the index on every push to main. It runs read-only in CI, with no API key to store.

yaml
name: Carrickon:  push:    branches: [main]  pull_request:    branches: [main]permissions:  id-token: write  contents: readjobs:  carrick:    runs-on: ubuntu-latest    steps:      - uses: actions/checkout@v4        with:          fetch-depth: 0      - uses: carrick-tools/carrick@v1

Building the index has the full workflow, with on-demand rescans, dependency installs and monorepo setup.

Docs

Licence

Carrick has a free tier, and paid plans are on the pricing page. The scanner in this repository is source-available under the Elastic License 2.0. Copyright (c) 2026 Far Harbour B.V.

Development

See AGENTS.md for build, test, and contribution conventions.

bash
cargo testcargo fmtcargo clippy

Install the optional pre-commit hook to run formatting and tests before each commit:

bash
./scripts/install-hooks.sh

来源：README.md，提交 6ae7bb8

工具

0
该服务器需要登录，因此 SourceWeft 无法在没有账号的情况下读取其工具，也未收录。已连接账号所能看到的内容可能因账号及其权限而异。

版本历史

1
  1. v0.4.0最新Sep 27, 2026

评分

已满足适用检查项的 75%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。