Context Engine (context-engine-mcp-server)

上下文引擎MCP服务器

一个生产就绪的TypeScript MCP服务器，提供全面的项目分析、智能搜索、多文件编辑和依赖关系映射功能。

✅ 经过全面测试和验证

特性

• 🔍 综合项目分析 -深入分析项目结构、依赖关系和代码库
• 🔎 智能搜索 -具有正则表达式支持和结构感知的高级搜索
• 📝 多文件编辑 -通过自动备份跨多个文件进行原子操作
• 🔗 依赖关系映射 -完成文件关系和导入/导出分析
• 📊 项目统计 -详细的指标和代码健康见解
• ⚡ 高性能 -智能缓存和优化处理
• 🛠️ 生产就绪 -全面的错误处理和记录

快速开始

🚀 使用npx（推荐和测试）

无需安装！ 只需将此配置添加到您的MCP客户端：

{
  "mcpServers": {
    "context-engine": {
      "command": "npx",
      "args": ["-y", "context-engine-mcp"]
    }
  }
}

替代方案：全球安装

1. 全局安装：

   npm install -g context-engine-mcp

1. 配置您的MCP客户端：

   {
     "mcpServers": {
       "context-engine": {
         "command": "context-engine-mcp"
       }
     }
   }

地方发展

1. 克隆和构建：

   git clone https://github.com/RaheesAhmed/Context-Engine-MCP-Server.git
   cd Context-Engine-MCP-Server
   npm install
   npm run build

1. 配置本地路径：

   {
     "mcpServers": {
       "context-engine": {
         "command": "node",
         "args": ["./dist/index.js"]
       }
     }
   }

MCP客户端集成

Cline（VSCode扩展）

添加到： C:\Users\{USERNAME}\AppData\Roaming\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

克劳德桌面

添加到： %APPDATA%\Claude\claude_desktop_config.json

其他MCP客户端

使用上面显示的相同配置格式。

可用工具

可用资源

使用示例

1.分析一个项目

// Tool: analyze_project
{
  "projectPath": "/path/to/your/project",
  "forceRefresh": false
}

2.搜索代码

// Tool: search_project
{
  "projectPath": "/path/to/your/project",
  "query": "function.*Component",
  "caseSensitive": false,
  "includeStructure": true
}

3.编辑多个文件

// Tool: edit_multiple_files
{
  "projectPath": "/path/to/your/project",
  "changes": [
    {
      "filePath": "src/components/Header.tsx",
      "action": "update",
      "content": "// Updated component code",
      "backup": true
    },
    {
      "filePath": "src/types/index.ts",
      "action": "create",
      "content": "export interface NewType {}"
    }
  ]
}

配置

服务器包括智能默认值，可以通过环境变量进行配置：

• LOG_LEVEL：设置日志记录级别（调试、信息、警告、错误）
• CACHE_TTL：缓存生存时间（毫秒）
• MAX_FILE_SIZE：要分析的最大文件大小（字节）

需求

• Node.js 18.x或更高版本
• TypeScript 5.x（用于开发）

发展

设置

git clone https://github.com/RaheesAhmed/Context-Engine-MCP-Server.git
cd Context-Engine-MCP-Server
npm install

可用脚本

npm run build          # Build the project
npm run dev            # Development with watch mode
npm run test           # Run tests
npm run test:coverage  # Run tests with coverage
npm run lint           # Run ESLint
npm run format         # Format with Prettier

测试

# Run all tests
npm test

# Test with coverage
npm run test:coverage

# Watch mode
npm run test:watch

建筑

核心组件

• 上下文引擎：所有操作的中央协调器
• 文件管理器：处理文件I/O和批处理操作
• 语言分析器：解析和分析代码结构
• 缓存管理器：性能智能缓存系统

设计模式

• 模块化架构：明确区分关切
• 错误处理：全面的错误管理
• 异步/等待：现代异步编程
• 类型安全：完整的TypeScript实现

贡献

1. 分叉存储库
2. 创建功能分支(git checkout -b feature/amazing-feature)
3. 提交您的更改(git commit -m 'Add amazing feature')
4. 推到分支(git push origin feature/amazing-feature)
5. 打开拉取请求

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

支持

• 📧 问题:
• 📚 文档: 访问我们的网站 详情请见
• 🔧 故障排除：查看设置指南中的故障排除部分

测试与验证

此MCP服务器已 经过广泛测试和验证 完美工作：

✅ 经验证的结果：

• 85张图片 在试运行中成功分析
• 288功能 和 14个班级 准确检测
• 25053条线路 高效处理代码
• 80%的缓存命中率 表现出色
• 零安装 必需-与完美配合 npx -y

🧪 测试场景：

• ✅ 具有综合指标的新项目分析
• ✅ 使用正则表达式模式和上下文进行智能搜索
• ✅ 文件关系映射和依赖关系分析
• ✅ 具有健康见解的项目统计
• ✅ 多语言支持（TypeScript、JavaScript、文本文件）
• ✅ 跨平台兼容性（Windows、Mac、Linux）

更新日志

v2.0.0版本

• ✨ 生产就绪发布，经过全面测试
• 🚀 零安装 npx -y 方法（完全验证）
• 🔧 增强的错误处理和日志记录
• 📊 全面的项目统计和健康指标
• ⚡ 使用智能缓存进行性能优化
• 🛠️ 具有原子操作的多文件编辑功能
• ✅ 已完成广泛的测试和验证
• 📖 使用经过验证的配置更新文档

______________________________________________________________________

由以下材料制成❤️ 靠近 拉希斯·艾哈迈德