🚀 代码上下文提供程序 MCP

代码上下文提供程序 MCP 是一个 MCP 服务器，可提供代码上下文和分析功能。它借助 WebAssembly Tree - sitter 解析器来提取目录结构和代码符号，且无零原生依赖。

🚀 快速开始

安装

npm install code-context-provider-mcp

使用示例

const mcp = require('code-context-provider-mcp');

// 分析目录结构和代码符号
const result = await mcp.analyze('path/to/your/project', {
  filePatterns: ['**/*.js', '**/*.ts', '**/*.py'],
  maxDepth: 3,
  analyzeSymbols: true
});

console.log(result);

参数说明

interface Options {
  /**
   * 要包含的文件模式（支持通配符和扩展名）
   */
  filePatterns?: string[];
  
  /**
   * 最大遍历深度（0 表示只分析根目录）
   */
  maxDepth?: number;
  
  /**
   * 是否分析代码符号
   */
  analyzeSymbols?: boolean;
}

✨ 主要特性

• 生成目录树结构
• 分析 JavaScript/TypeScript 和 Python 代码
• 提取代码符号（支持 JavaScript (.js)、JSX (.jsx)、TypeScript (.ts)、TSX (.tsx) 和 Python (.py)）
• 支持自定义文件模式匹配
• 限制深度遍历（适用于大型项目）

💻 使用示例

基础用法

const mcp = require('code-context-provider-mcp');

// 分析目录结构和代码符号
const result = await mcp.analyze('path/to/your/project', {
  filePatterns: ['**/*.js', '**/*.ts', '**/*.py'],
  maxDepth: 3,
  analyzeSymbols: true
});

console.log(result);

高级用法

// 只分析根目录和其直接子目录
const result = await mcp.analyze('path/to/your/project', {
  maxDepth: 1
});

📚 详细文档

示例输出

{
  "directories": {
    "root": {
      "children": ["src", "public"],
      "files": ["package.json"]
    },
    "src": {
      "children": ["components", "utils"],
      "files": ["index.js", "types.ts"]
    }
  },
  "symbols": {
    "JavaScript": ["Component", "useContext"],
    "TypeScript": ["useContext"],
    "Python": []
  }
}

文件模式示例

• **/*.js：匹配所有 JavaScript 文件
• config.*：匹配所有配置文件（如 config.js、config.json）
• package.json：匹配 package.json 文件
• *.ts, *.tsx：匹配 TypeScript 和 TSX 文件

处理大型项目

使用 maxDepth 参数限制遍历深度，示例如下：

// 只分析根目录和其直接子目录
const result = await mcp.analyze('path/to/your/project', {
  maxDepth: 1
});

支持的语言

• JavaScript (.js)
• JSX (.jsx)
• TypeScript (.ts)
• TSX (.tsx)
• Python (.py)

开发环境搭建

克隆仓库

git clone https://github.com/your-username/code-context-provider-mcp.git
cd code-context-provider-mcp

安装依赖

npm install

设置 WASM 解析器

npm run setup

📄 许可证

本项目采用 MIT 许可证。

📞 联系方式

• 邮箱 (abcd49800@gmail.com)
• Discord (CodePlayground)