AI导哈

代码上下文服务工具

codeweave是一个自托管的代码上下文服务器，通过MCP协议为AI编程工具提供深度代码上下文支持，包括文件树、全文搜索、Git历史、依赖关系等，无需第三方API密钥。

  • by MdAbdullahAlMahmud
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 MdAbdullahAlMahmud/codeweave

使用说明

代码编织

通过MCP（一个用于代码库的自托管、零-API-key上下文服务器）使任何回购都能立即做好AI准备。

codeweave与您的AI编码工具一起在本地运行。它将整个仓库索引到一个快速的SQLite数据库中，并将其作为 主控程序 服务器，为AI助手提供有关代码的深入、准确的上下文——文件树、全文搜索、git历史、依赖关系、堆栈检测和编码约定——而无需将代码发送给第三方。

快速开始

# 1. Install globally (or use npx)
npm install -g codeweave

# 2. Generate a config in your project root
cd /path/to/your/project
codeweave init

# 3. Start the MCP server
codeweave start

然后将codeweave添加到您的AI客户端（请参阅 AI客户端设置 在......下面

特性

特性 描述
文件树 带注释的JSON树，每个文件都有语言标签
全文搜索 带波特词干的SQLite FTS5——亚毫秒级查询
文件内容 带可选行范围切片的行号文件内容
Git历史记录 最近提交的作者、日期和更改的文件
依赖图 解析自 package.json, Cargo.toml, go.mod, pyproject.toml，还有6个
堆栈检测 自动检测语言、框架、数据库、测试运行器、样式
公约检测 文件命名样式、导入模式、组件结构
文件监视器 用300ms去抖动在<1s内重新索引更改的文件
增量索引 基于mtime的缓存——热启动时间<30ms
API密钥为零 完全在本地运行。没有云。没有遥测。

AI客户端设置

codeweave使用stdio MCP传输，并与任何兼容MCP的客户端配合使用。

克劳德代码

添加 .claude/settings.json 在项目根目录中：

{
  "mcpServers": {
    "codeweave": {
      "command": "npx",
      "args": ["codeweave"],
      "cwd": "."
    }
  }
}

光标

添加 .cursor/mcp.json 在项目根目录中：

{
  "mcpServers": {
    "codeweave": {
      "command": "npx",
      "args": ["codeweave"],
      "cwd": "${workspaceFolder}"
    }
  }
}

泽德

添加 ~/.config/zed/settings.json:

{
  "context_servers": {
    "codeweave": {
      "command": {
        "path": "npx",
        "args": ["codeweave"]
      }
    }
  }
}

Continue.dev

添加 .continue/config.json:

{
  "mcpServers": [
    {
      "name": "codeweave",
      "command": "npx",
      "args": ["codeweave"]
    }
  ]
}

CLI 参考

codeweave [command] [options]

Commands:
  start    Start the MCP server (default)
  init     Generate codeweave.config.js in the current directory
  status   Show indexing stats for the current repo

Options:
  --verbose    Enable debug logging
  -V, --version  Show version number
  -h, --help     Show help

查看完整 CLI参考→

配置

跑 codeweave init 生成a codeweave.config.js。所有字段都是可选的——默认值适用于大多数项目。

// codeweave.config.js
export default {
  // Directories to index (relative to config file)
  include: ['src'],

  // Extra patterns to exclude beyond .gitignore
  exclude: ['**/*.generated.ts'],

  // Files larger than this are truncated (KB)
  maxFileSizeKB: 100,

  // How many git commits to read
  gitDepth: 50,

  // Port for future HTTP transport
  port: 3333,

  // Enable verbose/debug logging
  verbose: false,
};

查看完整 配置参考→

MCP工具

codeweave公开了7个人工智能助手可以调用的MCP工具：

工具 说明
get_file_tree 带注释的文件树，可按语言过滤
get_file 带有行号和可选行范围的文件内容
search_codebase 使用片段上下文进行全文搜索
get_conventions 检测到命名样式、导入模式、测试框架
get_dependencies 解析清单文件中的所有依赖项
get_git_history 最近的提交，可按文件路径过滤
get_stack_info 检测到的语言、框架、数据库、工具

查看完整 API 参考→

建筑

your repo on disk
      │
      ▼
┌─────────────────────────────────────────────────────┐
│                   codeweave process                  │
│                                                     │
│  ┌──────────┐  ┌──────────┐  ┌───────────────────┐ │
│  │ File     │  │   Git    │  │  Manifest Parser  │ │
│  │ Scanner  │  │  Reader  │  │  (9 formats)      │ │
│  └────┬─────┘  └────┬─────┘  └────────┬──────────┘ │
│       │              │                 │            │
│       └──────────────┴─────────────────┘            │
│                       │                             │
│              ┌────────▼────────┐                   │
│              │  SQLite DB      │                   │
│              │  (WAL + FTS5)   │◄──────────────────┤
│              └────────┬────────┘     File Watcher  │
│                       │                             │
│       ┌───────────────┼───────────────┐            │
│       ▼               ▼               ▼            │
│  get_file_tree   search_codebase  get_stack_info   │
│  get_file        get_conventions  get_dependencies │
│  get_git_history                                   │
│       │                                            │
│       └──────────────────────────────────────────┐ │
│                    MCP Server (stdio)             │ │
└───────────────────────────────────────────────────┘
                        │
              ┌─────────┘
              ▼
    AI client (Claude Code, Cursor, Zed…)

关键设计决策：

  • SQLite在内存中 --完整的文件内容存储在磁盘上，而不是Node.js堆中。无论仓库大小如何，内存使用率都保持不变。
  • FTS5搬运工标记器 --处理词干的全文搜索(authenticate → authenticat)没有任何外部依赖。
  • mtime缓存 --未更改的文件永远不会被重新读取。1K文件仓库的热启动需要大约28毫秒。
  • 标准运输 --没有端口冲突，没有防火墙规则。适用于AI客户端可以生成子流程的任何环境。

支持的堆栈

codeweave检测并解析：

语言： TypeScript、JavaScript、Python、Go、Rust、Dart、Ruby、PHP、Java、Kotlin、Swift等

框架： Next.js、Nuxt、Remix、SvelteKit、Astro、Vite+React、Express、Fastify、NestJS、Hono、Django、Flask、FastAPI、Rails、Laravel、Symfony、Angular、Vue、Svelte

数据库： Prisma、TypeORM、Drizzle、MongoDB、PostgreSQL、MySQL、SQLite、Redis、Sequelize

清单格式： package.json, pubspec.yaml, Cargo.toml, go.mod, requirements.txt, pyproject.toml, composer.json, Gemfile, build.gradle

贡献

欢迎投稿！请阅读 贡献.md 了解如何分叉、开发、测试和提交PR的指南。

git clone https://github.com/MdAbdullahAlMahmud/codeweave.git
cd codeweave
npm install
npm test         # run tests
npm run typecheck  # type check
npm run lint     # lint

许可证

麻省理工学院©阿卜杜拉——见 许可证 了解详情。

相关 MCP