上下文引擎MCP服务器

Name: 上下文引擎MCP服务器
Author: RaheesAhmed

作者：RaheesAhmed5 星标更新：2025-08-27

安装使用来源：spider==github.com

项目介绍

Context Engine MCP Server

一款生产就绪的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

Claude桌面版

添加到：%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. 分析一个项目

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

2. 搜索代码

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

3. 编辑多个文件

// 工具: edit_multiple_files
{
  "projectPath": "/path/to/your/project",
  "changes": [
    {
      "filePath": "src/components/Header.tsx",
      "action": "update",
      "content": "// 更新后的组件代码",
      "backup": true
    },
    {
      "filePath": "src/types/index.ts",
      "action": "create",
      "content": "export interface NewType {}"
    }
  ]
}

配置

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

LOG_LEVEL: 设置日志级别（debug, info, warn, error）
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-M
npm install

可用脚本

npm run build          # 构建项目
npm run dev            # 开发模式，带监视
npm run test           # 运行测试
npm run test:coverage  # 运行带有覆盖率的测试
npm run lint           # 运行ESLint
npm run format         # 使用Prettier格式化

测试

# 运行所有测试
npm test

# 带有覆盖率的测试
npm run test:coverage

# 监视模式
npm run test:watch

架构

核心组件

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

设计模式

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

贡献

分叉仓库
创建您的功能分支（git checkout -b feature/amazing-feature）
提交更改（git commit -m '添加精彩功能'）
推送到分支（git push origin feature/amazing-feature）
打开拉取请求

许可证

此项目根据MIT许可证发布 - 查看LICENSE文件以获取详细信息。

支持

📧 问题：GitHub问题
📚 文档：访问我们的网站获取更多详情
🔧 故障排除：查看设置指南中的故障排除部分

测试与验证

此MCP服务器经过广泛测试和验证，可以完美运行：

✅ 证明结果：

成功分析了85个文件
准确检测到了288个函数和14个类
高效处理了25,053行代码
80%缓存命中率展示了出色的性能
无需安装 - 使用npx -y完美工作

🧪 测试场景：

✅ 新项目的全面分析和度量指标
✅ 带有正则表达式模式和上下文的智能搜索
✅ 文件关系映射和依赖分析
✅ 带有健康洞察的项目统计
✅ 多语言支持（TypeScript、JavaScript、文本文件）
✅ 跨平台兼容性（Windows、Mac、Linux）

更改日志

v2.0.0

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

由Rahees Ahmed制作 ❤️