codeweave (Md Abdullah Al Mahmud)

代码编织

通过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客户端设置 在......下面

______________________________________________________________________

特性

______________________________________________________________________

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工具：

查看完整 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

______________________________________________________________________

许可证

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