AroMCP
一套全面的MCP（模型上下文协议）服务器，被设计为人工智能驱动开发工作流程的智能工具。AroMCP提供确定性操作和人工智能编排的流程，使Claude Code能够高效地执行复杂的开发任务，同时保持令牌优化。
🚀 生产就绪服务器
AroMCP由以下部分组成 5台功能齐全的MCP服务器，每个都提供专门的开发工具：
1. 文件系统服务器 -文件操作
- 工具:
list_files,read_files,write_files（3个工具） - 目的：具有高级glob模式和分页的文件I/O操作
- 特性：多文件操作、自动目录创建、光标分页
2. 构建服务器 -开发自动化
- 工具:
check_typescript,lint_project,run_test_suite（3个工具） - 目的：构建自动化、linting和测试
- 特性：ESLint集成、TypeScript错误检查、分页测试执行
3. 分析服务器 -TypeScript分析
- 工具:
find_references,get_function_details,analyze_call_graph（3个工具） - 目的：高级TypeScript代码分析和符号解析
- 特性：符号引用、函数详细信息、静态调用图分析
4. 标准服务器 -编码指南
- 工具：10个工具，包括
hints_for_file,register,add_rule,get_session_stats - 目的：智能编码标准管理，令牌减少70-80%
- 特性：上下文感知提示、会话管理、ESLint规则集成
5. 工作流服务器 -国家管理⚠️ 发展中
- 状态: 🚧 尚未运行 -正在积极开发中
- 工具：计划为工作流执行和状态管理提供14个工具
- 目的：长时间运行的开发过程的持久状态（完成时）
- 特性：工作流编排、状态持久性、检查点/恢复功能（计划中）
总计: 19个生产就绪工具 跨4个功能服务器+1个开发服务器
⚡ 快速开始
# 1. Clone and install
git clone
cd AroMCP
uv sync --dev
# 2. Create system-wide symlink (recommended)
sudo mkdir -p /usr/mcp
sudo ln -sf $(pwd) /usr/mcp/AroMCP
# 3. Configure Claude Desktop with desired servers
# See documentation/INSTALLATION.md for complete setup guide📋 完整安装指南 -所有部署选项的详细设置
🚀 独立服务器架构
AroMCP使用单独的服务器架构，其中每个服务器提供专门的功能：
# Run individual servers (recommended approach)
./scripts/run-server.sh filesystem # File operations (3 tools)
./scripts/run-server.sh build # Build automation (3 tools)
./scripts/run-server.sh analysis # TypeScript analysis (3 tools)
./scripts/run-server.sh standards # Coding standards (10 tools)
# ./scripts/run-server.sh workflow # ⚠️ IN DEVELOPMENT - NOT FUNCTIONAL YET
# Available aliases
./scripts/run-server.sh fs # filesystem alias
./scripts/run-server.sh std # standards alias
./scripts/run-server.sh wf # workflow alias
# Background mode
./scripts/run-server.sh filesystem --background
# Management scripts
./scripts/run-all-servers.sh # Start all servers in background
./scripts/health-check.py # Check server health
./scripts/stop-all-servers.sh # Stop all servers架构优势：
- 🎯 选择性部署 -仅启用所需的服务器
- 📦 最小依赖性 -每台服务器都有最低限度的、重点突出的要求
- 🚀 更好的性能 -减少每台服务器的内存占用
- 🔧 独立缩放 -根据使用模式扩展服务器
看 个人服务器指南 详细配置和Claude Desktop设置。
Claude代码命令安装
AroMCP包括用于标准管理的增强型Claude Code命令。将它们安装到您的Claude配置中：
# Run the install script to copy commands to ~/.claude
./install.sh安装内容：
- 标准命令 -
standards:create,standards:generate,standards:update,standards:fix - 专业代理 -用于并行工作流执行的批处理代理
- 模板 -编码标准模板和模式
- 安全安装 -自动备份现有配置
可用命令：
# Create new coding standards interactively
claude standards:create
# Generate AI hints and ESLint rules from standards
claude standards:generate
# Update existing standards with new content
claude standards:update
# Apply standards to changed files with parallel processing
claude standards:fix
claude standards:fix branch main # Fix changes against specific branch
claude standards:fix --resume # Resume interrupted workflow安装脚本：
- ✅ 安全安装 -备份现有
~/.claude带有时间戳的内容 - ✅ 智能检测 -通过自动查找标准目录
.aromcp/.standards-dir - ✅ 无覆盖 -命令以当前目录作为项目根目录工作
- ✅ 用户确认 -覆盖现有文件前的询问
开发命令
# Testing and quality checks
uv run pytest # Run tests
uv run black src/ tests/ # Format code
uv run ruff check src/ tests/ # Lint
uv run ruff check --fix src/ tests/ # Auto-fix lintingESLint集成的项目依赖关系
使用AroMCP时 parse_lint_results 在目标项目中使用标准ESLint规则的工具，确保安装了以下依赖项：
所需依赖关系
# Install ESLint v9+ and TypeScript parser
npm install --save-dev eslint @typescript-eslint/parser
# Or with yarn
yarn add --dev eslint @typescript-eslint/parserNext.js项目
对于Next.js项目，ESLint通常是预先配置的。确保您拥有：
# Usually included in Next.js by default
npm install --save-dev eslint eslint-config-next @typescript-eslint/parser解释依赖关系
eslint（v9.0.0+）-使用平面配置格式进行linting时需要@typescript-eslint/parser-解析AroMCP标准规则中的TypeScript文件所必需的eslint-config-next-Next.js ESLint配置（仅限Next.js项目）
ESLint配置
AroMCP在以下位置生成ESLint v9平面配置文件 .aromcp/eslint/standards-config.js 即：
- 使用
@typescript-eslint/parser支持TypeScript - 包括常见目录的忽略模式(
.aromcp/,node_modules/,dist/,build/,.next/) - 仅适用于JavaScript/TypeScript文件(
**/*.{js,jsx,ts,tsx}) - 独立于现有项目ESLint配置运行
使用说明
- Next.js项目：AroMCP运行两者
npm run lint（Next.js配置）和标准ESLint分开 - 其他项目：AroMCP可以运行标准ESLint或常规ESLint
- 无冲突：ESLint使用的标准
--no-config-lookup避免与现有冲突.eslintrc.*文件
🔧 核心能力
编排ESLint规则生成
根据markdown编码标准生成特定于项目的ESLint规则：
# MCP orchestrator analyzes project and creates action plan
action_plan = aromcp.generate_eslint_rules(
target_project_root="/path/to/project",
standards_dir=".aromcp/standards"
)
# Claude Code follows the structured plan to generate rules
# Result: Complete ESLint ruleset + AI context tailored to your project简化工具（推荐用于AI代理）
# Simple, intuitive operations with 2-3 parameters
files = aromcp.list_files(patterns=["**/*.ts"])
content = aromcp.read_files(file_paths=["src/main.ts", "src/utils.ts"])
aromcp.write_files(files={"output.json": json.dumps(analysis)})
# Quality checks made simple
aromcp.lint_project(linter="eslint")
aromcp.check_typescript()
aromcp.run_tests()
# Individual quality checks
aromcp.lint_project()
aromcp.check_typescript()
aromcp.run_tests()高级文件操作（高级用户）
# Full-featured operations with advanced options
files = aromcp.get_target_files(patterns=["**/*.ts"], page=1, max_tokens=20000)
content = aromcp.read_files_batch(file_paths=["src/main.ts"], encoding="auto", expand_patterns=True)
aromcp.write_files_batch(files={"output.json": json.dumps(analysis)}, create_backup=True)高级构建和质量自动化
# Advanced workflows with full configuration
aromcp.parse_lint_results(target_files=["src/**/*.ts"], use_standards_eslint=True)
aromcp.parse_typescript_errors(include_warnings=True, use_build_command=False)
aromcp.run_test_suite(pattern="**/*.test.ts", coverage=True)标准驱动开发
# Context-aware coding standards with smart compression and session management
standards = aromcp.hints_for_file(
"src/api/routes/user.ts",
session_id="dev-session-123" # Enable cross-file deduplication
)
# Standards are compressed based on context (70-80% token reduction)
# Previously loaded rules are referenced, not repeated
# Session statistics and context analysis
stats = aromcp.get_session_stats(session_id="dev-session-123")
context = aromcp.analyze_context(file_path="src/api/routes/user.ts")
# TypeScript code analysis
aromcp.find_references(symbol_name="calculateTotal", file_path="src/utils.ts")
aromcp.get_function_details(function_name="processPayment", file_path="src/payment.ts")
aromcp.analyze_call_graph(entry_points=["src/main.ts"], max_depth=3)🔗 Claude代码集成
AroMCP与Claude Code无缝集成，以增强AI驱动的开发。
快速设置
- 安装AroMCP （见上文快速入门）
- 配置Claude代码 -将AroMCP添加到您的MCP服务器
- 设置环境 -
export MCP_FILE_ROOT=/path/to/your/project - 复制集成模板 -复制以下内容
CLAUDE-MD-HINT.md进入你的项目CLAUDE.md文件
集成模板
📋 CLAUDE-MD-HINT.MD -包含使用模式和最佳实践的完整模板
要将AroMCP与您的项目集成：
- 从复制markdown内容
documentation/CLAUDE-MD-HINT.md - 将其粘贴到项目的
CLAUDE.md文件 - 根据您的特定项目需求定制图案
📚 文档
集成和设置
- Claude代码集成 -完整的设置和配置指南
工具使用指南
高级功能
- ESLint规则生成 -人工智能根据标准生成规则
- 技术架构 -详细设计和实施
实施指南
- 代码分析V2 -编排规则生成架构
🏗️ 建筑
统一服务器设计
src/aromcp/
├── main_server.py # Unified FastMCP server
├── filesystem_server/
│ └── tools/ # File operations, git, parsing
├── build_server/
│ └── tools/ # Build, lint, test automation
├── analysis_server/
│ ├── tools/ # Standards, security, quality analysis
│ │ ├── generate_eslint_rules.py # 🆕 Orchestrator tool
│ │ ├── analyze_project_structure.py # 🆕 Project analysis
│ │ └── write_eslint_rule_file.py # 🆕 Action execution
│ ├── standards_management/ # Standards parsing and matching
│ ├── eslint_integration/ # ESLint rule generation support
│ └── standards_server/ # 🆕 V2 enhanced standards
│ ├── models/ # Enhanced rule structures
│ ├── services/ # Session, compression, context detection
│ └── utils/ # Token optimization, example generation关键设计原则
- 精心策划的情报：MCP协调分析，AI生成内容
- 建筑智能：按用途和运行时环境进行智能文件分类
- 并行处理：最多3个具有架构批处理的并发代理（每批最多5个文件）
- 原子操作：每个动作都是独立且可恢复的
- 项目不可知：动态分析适用于任何项目结构
- 代币高效：批处理操作可最大限度地减少上下文使用
- 安全第一：全程路径验证和输入净化
🛠️ 发展
贡献指南
- 模块化架构 -每个工具都有自己的实现文件
- 全面验证 -需要输入验证和安全检查
- 结构化错误 -使用一致的错误响应格式和代码
- 测试覆盖率 -为所有功能编写测试
- 文档 -更新新功能的相关使用指南
标准符合性
- 类型安全：具有现代Python语法的完整类型注释
- 错误处理：带有适当代码的结构化错误响应
- 安全：路径遍历保护和输入验证
- 演出：批处理操作和高效的文件处理
📄 许可证
\[许可证信息\]