使用说明
devtools mcp
一个包含特定于平台的MCP服务器的TypeScript单仓库，为AI代理开发工作流程提供可靠、强制的质量门。
概述
本项目实施的原则是 当AI代理做出更少的决策时，可靠性会提高通过提供内部处理整个工作流程的单个MCP工具，我们实现了约90-95%的可靠性，而仅使用文档方法的可靠性约为40-60%。
包裹
- @hitoshura25/核心 -所有平台MCP服务器的共享实用程序（内部）
- @日立25/mcp安卓系统 -安卓开发质量门MCP服务器（已发布）
快速开始
先决条件
- Node.js>=20.0.0
- pnpm>=9.0.0
- Java JDK（用于Android工具）
- Android SDK（用于Android工具）
安装
# Install pnpm if not already installed
npm install -g pnpm
# Install dependencies
pnpm install
# Build all packages
pnpm build
发展
# Run tests
pnpm test
# Run unit tests only (no Android SDK required)
pnpm test:unit
# Run integration tests (requires Android SDK)
pnpm test:integration
# Lint code
pnpm lint
# Clean build artifacts
pnpm clean
审阅者配置
实施工作流程使用人工智能审查员来验证规范。您可以配置要使用的审阅者。
快速启动（默认）
默认配置使用Ollama进行本地开发：
# Install Ollama and download OLMo model
ollama pull olmo-3.1:32b-think
ollama serve
推荐设置：免费本地+付费CI
为了获得最佳成本/效益，请使用 奥拉玛 本地（免费）和 开放路由 CI（约0.08美元/月）：
本地开发（.devtools/reviews.config.json）：
{
"reviewers": ["ollama"],
"backends": {
"ollama": {
"baseUrl": "http://localhost:11434",
"model": "olmo-3.1:32b-think"
}
}
}
CI环境（用env变量覆盖）：
export REVIEWERS=openrouter
export OPENROUTER_API_KEY=your_key # Get from https://openrouter.ai/keys
export OPENROUTER_MODEL=allenai/olmo-3.1-32b-think
可用后端
| 后端 | 成本 | 最适合 | 设置 |
|---|---|---|---|
| 奥拉玛 | 免费 | 仅限本地 | ollama pull olmo-3.1:32b-think |
| 开放路由 | ~$0.08/mo | CI环境 | 从获取API密钥 openrouter.ai |
| GitHub模型 | 不同 | CI与GitHub | 使用 GITHUB_TOKEN 或 GH_PAT |
看 docs/REVIEWERS.md 有关详细的配置选项、成本比较和故障排除。
建筑
核心原则：通过代码执行实现可靠性
根据我们的研究：
- 技能/文档：~40-60%的可靠性（代理可以跳过步骤）
- MCP工具调用技能：~60-75%的可靠性（代理可以跳过调用）
- 具有内部编排的单个MCP工具：~90-95%的可靠性 （一个决策点）
设计原则： 每个MCP工具都是独立的，并在内部处理其整个工作流程。代理做出一个决定（调用工具），其他一切都以确定性的方式执行。
单体仓库结构
devtools-mcp/
├── packages/
│ ├── core/ # Shared utilities (internal)
│ │ ├── src/
│ │ │ ├── executor.ts # Command execution
│ │ │ ├── discovery.ts # Project detection
│ │ │ ├── results.ts # Structured results
│ │ │ ├── errors.ts # Error parsing
│ │ │ └── progress.ts # Progress reporting
│ │ └── package.json
│ │
│ └── mcp-android/ # Android MCP server (published)
│ ├── src/
│ │ ├── server.ts # MCP server entry point
│ │ ├── cli.ts # CLI entry point
│ │ ├── tools/ # MCP tools implementation
│ │ └── parsers/ # Output parsers
│ └── package.json
│
├── .github/
│ └── workflows/
│ ├── ci.yml # CI tests
│ └── release.yml # Automated publishing
│
├── package.json # Root workspace config
├── pnpm-workspace.yaml
├── turbo.json
└── tsconfig.base.json
使用MCP服务器
使用克劳德代码
添加到您的Claude代码配置中：
{
"mcpServers": {
"android": {
"command": "npx",
"args": ["@hitoshura25/mcp-android"]
}
}
}
作为CLI工具
所有工具也可作为CLI命令使用：
# Install globally
npm install -g @hitoshura25/mcp-android
# Use CLI
mcp-android-cli validate-release-build --project-path .
mcp-android-cli setup-release-build --project-path .
出版
此monorepo使用 变更集 用于版本管理和发布。
创建变更集
# Create a changeset (run this when you make changes)
pnpm changeset
# Follow prompts to describe changes
出版
# Bump versions and update changelogs
pnpm changeset version
# Build and publish to npm
pnpm release
或者，创建一个PR，CI将自动处理版本控制。
贡献
- 创建要素分支
- 进行更改
- 运行测试：
pnpm test - 创建变更集：
pnpm changeset - 提交PR
测试策略
单元测试（始终在CI中运行）
单元测试使用模拟的外部命令，不需要Android SDK：
pnpm test:unit
集成测试（CI中可选）
集成测试运行实际的Gradle命令，并需要Android SDK：
export ANDROID_SDK_ROOT=/path/to/android/sdk
pnpm test:integration
未来扩展
计划平台包：
- @hitoshura25/mcp python -Python开发质量门
- @hitoshura25/mcp节点 -Node.js开发质量门
所有平台包将：
- 共享公用事业
@hitoshura25/core - 遵循双CLI+MCP接口模式
- 返回具有一致错误处理的结构化结果
许可证
麻省理工学院
