上下文引擎MCP服务器
一个生产就绪的TypeScript MCP服务器，提供全面的项目分析、智能搜索、多文件编辑和依赖关系映射功能。
✅ 经过全面测试和验证
特性
- 🔍 综合项目分析 -深入分析项目结构、依赖关系和代码库
- 🔎 智能搜索 -具有正则表达式支持和结构感知的高级搜索
- 📝 多文件编辑 -通过自动备份跨多个文件进行原子操作
- 🔗 依赖关系映射 -完成文件关系和导入/导出分析
- 📊 项目统计 -详细的指标和代码健康见解
- ⚡ 高性能 -智能缓存和优化处理
- 🛠️ 生产就绪 -全面的错误处理和记录
快速开始
🚀 使用npx（推荐和测试）
无需安装！ 只需将此配置添加到您的MCP客户端：
{
"mcpServers": {
"context-engine": {
"command": "npx",
"args": ["-y", "context-engine-mcp"]
}
}
}替代方案：全球安装
- 全局安装：
npm install -g context-engine-mcp- 配置您的MCP客户端：
{
"mcpServers": {
"context-engine": {
"command": "context-engine-mcp"
}
}
}地方发展
- 克隆和构建：
git clone https://github.com/RaheesAhmed/Context-Engine-MCP-Server.git
cd Context-Engine-MCP-Server
npm install
npm run build- 配置本地路径：
{
"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客户端
使用上面显示的相同配置格式。
可用工具
| 工具 | 说明 |
|---|---|
analyze_project | 使用缓存进行全面的项目分析 |
search_project | 跨项目文件的智能搜索 |
edit_multiple_files | 带备份的原子多文件编辑 |
get_file_relationships | 文件依赖关系和导入/导出映射 |
get_project_stats | 详细的项目指标和健康见解 |
clear_cache | 清除所有缓存的项目数据 |
可用资源
| 资源 | URI | 描述 |
|---|---|---|
| 项目分析 | context://project-analysis | 项目结构和背景数据 |
| 搜索结果 | context://search-results | 智能搜索功能 |
| 文件关系 | context://file-relationships | 依赖关系映射信息 |
| 项目统计 | context://project-stats | 健康指标和见解 |
使用示例
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实现
贡献
- 分叉存储库
- 创建功能分支(
git checkout -b feature/amazing-feature) - 提交您的更改(
git commit -m 'Add amazing feature') - 推到分支(
git push origin feature/amazing-feature) - 打开拉取请求
许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
支持
- 📧 问题:
- 📚 文档: 访问我们的网站 详情请见
- 🔧 故障排除：查看设置指南中的故障排除部分
测试与验证
此MCP服务器已 经过广泛测试和验证 完美工作：
✅ 经验证的结果：
- 85张图片 在试运行中成功分析
- 288功能 和 14个班级 准确检测
- 25053条线路 高效处理代码
- 80%的缓存命中率 表现出色
- 零安装 必需-与完美配合
npx -y
🧪 测试场景：
- ✅ 具有综合指标的新项目分析
- ✅ 使用正则表达式模式和上下文进行智能搜索
- ✅ 文件关系映射和依赖关系分析
- ✅ 具有健康见解的项目统计
- ✅ 多语言支持（TypeScript、JavaScript、文本文件）
- ✅ 跨平台兼容性（Windows、Mac、Linux）
更新日志
v2.0.0版本
- ✨ 生产就绪发布，经过全面测试
- 🚀 零安装
npx -y方法（完全验证） - 🔧 增强的错误处理和日志记录
- 📊 全面的项目统计和健康指标
- ⚡ 使用智能缓存进行性能优化
- 🛠️ 具有原子操作的多文件编辑功能
- ✅ 已完成广泛的测试和验证
- 📖 使用经过验证的配置更新文档
______________________________________________________________________
由以下材料制成❤️ 靠近 拉希斯·艾哈迈德