Ts Diagnostics MCP

MCP开发工具

提供方 GNARC0TICS

开发工具 未标注 无需鉴权 社区 / 第三方 Claude DesktopClaude

一个提供实时TypeScript类型检查诊断的服务,通过智能缓存和单后台进程优化多AI代理在TypeScript代码库中的协作效率。

一句话选型结论

按资料字段整理

Ts Diagnostics MCP 属于开发工具类 MCP 服务器,传输方式未标注,无需鉴权,可直接接入 Claude Desktop、Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 3 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

开发工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

TypeScript诊断TypeScript本地部署实时类型检查智能缓存多代理协作开发效率

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Ts Diagnostics MCP当前 未标注 未标注 未标注 无 2026-05-17
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方GNARC0TICS上游标注的维护方 GNARC0TICS
分类开发工具本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

10.0 KB
来自项目仓库与上游目录的原文,未做删改

TypeScript 诊断 MCP

实时 TypeScript 类型检查,无需频繁重新编译 - 一个模型上下文协议(MCP)服务器,提供带智能缓存的实时TypeScript诊断,非常适合在TypeScript代码库中工作的AI代理。

问题

当多个AI代理同时在一个TypeScript代码库中工作时,它们通常会运行 tsc 或者反复输入类型检查命令,导致:

  • 性能大幅下降 - 每个代理都会触发全面重新编译
  • 系统变慢 - 多个并发的TypeScript进程消耗CPU/内存
  • 冗余工作 - 相同的文件被反复进行类型检查
  • 客服响应不及时 - 代理等待缓慢编译完成后再继续执行

解决方案

ts-diagnostics-mcp 运行TypeScript编译器 观看模式 一旦(系统)建立起来,就能维护一个实时更新的诊断缓存,所有代理都可以即时查询:

  • 快80%-95% 比跑步(更……) tsc 反复地
  • 单一后台进程 服务于所有代理
  • 即时查询 - 毫秒而不是秒
  • 单仓库支持 - 无缝处理多个软件包
  • 智能缓存 - 具有文件级粒度的LRU缓存

特点/特性

  • 通过MCP实现TypeScript实时诊断
  • 单仓库支持 - 自动检测 pnpm、yarn、npm 工作区、Rush、Lerna
  • 智能缓存 - 可配置大小限制的LRU缓存
  • 数据包过滤 - 按工作区包查询诊断信息
  • 快速查询 - has_errors() 在微秒之内
  • 手表模式 TypeScript 编译器 API 支持增量构建
  • 零配置 - 自动检测项目结构
  • 灵活的 - 支持单个项目和单体仓库(monorepos)

安装

无需安装!只需通过 npx 进行配置和运行。

Claude Desktop(克劳德桌面版)

  1. 编辑您的Claude桌面配置文件:
  • macOS(发音为 /ˈmækɒs/): ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json
  1. 添加此配置:```json
    {
    "mcpServers": {
    "ts-diagnostics": {
    "command": "npx",
    "args": [
    "-y",
    "ts-diagnostics-mcp@latest",
    "/absolute/path/to/your/typescript/project"
    ]
    }
    }
    }

3. **重启Claude桌面版**

### 克劳德·科德(CLI)

添加到你的 `.mcp.json`:```json
{
"mcpServers": {
"ts-diagnostics": {
"command": "npx",
"args": [
"-y",
"ts-diagnostics-mcp@latest",
"/absolute/path/to/your/typescript/project"
]
}
}
}

备选方案:全局安装

如果您更倾向于全局安装:```bash
npm install -g ts-diagnostics-mcp


然后进行配置:```json
{
"mcpServers": {
"ts-diagnostics": {
"command": "ts-diagnostics-mcp",
"args": ["/absolute/path/to/your/project"]
}
}
}

快速入门

1. 配置(见上文安装部分)

2. 开始在Claude中使用```

Hey Claude, check if there are any TypeScript errors in the project.


克劳德将使用 `has_errors` 无需运行 tsc,即可即时检查的工具!

## 使用示例

### 对于人工智能代理```
# Quick error check (microseconds)
Tool: has_errors
Result: { "hasErrors": true }

# Get all errors across project
Tool: get_all_diagnostics
Result: { errors: 12, warnings: 3, diagnostics: [...] }

# Check specific file
Tool: get_file_diagnostics
Args: { "filePath": "src/server/auth.ts" }

# Get diagnostics for specific package (monorepo)
Tool: get_package_diagnostics
Args: { "packageName": "@degentalk/server" }

# Get summary counts
Tool: get_diagnostic_count
Result: { errors: 12, warnings: 3, suggestions: 0 }

# List available packages
Tool: list_packages
Result: { packages: ["@degentalk/app", "@degentalk/server", ...] }

可用的MCP工具

工具 描述 速度
has_errors 检查错误的布尔值 实时(微秒)
get_diagnostic_count 获取错误/警告计数 瞬时(微秒)
get_all_diagnostics 获取所有诊断信息 快速(毫秒)
get_file_diagnostics 获取特定文件的诊断信息 快速(毫秒)
get_package_diagnostics 获取包的诊断信息 速度(毫秒)
get_watch_status 检查手表进程状态 即时
get_cache_stats 查看缓存性能 立即
list_packages 列出单体仓库包 即时
clear_cache 清除诊断缓存 立即

配置

自动检测(默认)

无需配置!服务器自动检测:

  • 单一仓库类型(pnpm、yarn、npm、Rush、Lerna)
  • 工作区包
  • TypeScript 配置

自定义配置

创建 .ts-diagnostics.json 在你的项目根目录中:```json
{
"maxCacheSize": 100,
"debounceMs": 500,
"enableIncrementalMode": true,
"autoDetectWorkspaces": true,
"ignorePatterns": [
"/*.test.ts",
"
/.spec.ts",
"
/test/",
"
/migrations/*"
]
}


**默认忽略模式** (始终适用):

- `**/node_modules/**`
- `**/dist/**`
- `**/build/**`
- `**/.git/**`
- `**/coverage/**`
- `**/.next/**`
- `**/.turbo/**`
- `**/.cache/**`
- `**/out/**`
- `**/*.min.js`
- `**/*.bundle.js`
- `**/.tsbuildinfo`

添加您自己的模式以排除诊断中的额外文件。

### 环境变量```bash
TS_DIAG_MAX_CACHE_SIZE=200     # Cache size in MB
TS_DIAG_DEBOUNCE_MS=300        # Debounce delay
TS_DIAG_INCREMENTAL=true       # Enable incremental builds
TS_DIAG_AUTO_DETECT=true       # Auto-detect workspaces

手动配置

对于复杂的设置,请手动指定配置:```json
{
"projectRoot": "/path/to/project",
"tsConfigs": [
{
"configPath": "/path/to/packages/app/tsconfig.json",
"name": "@myapp/app",
"rootDir": "/path/to/packages/app"
},
{
"configPath": "/path/to/packages/server/tsconfig.json",
"name": "@myapp/server",
"rootDir": "/path/to/packages/server"
}
]
}


## 单体仓库支持

### 支持的单体仓库工具

- ✅ **pnpm 工作区(或项目空间)** (通过 `pnpm-workspace.yaml`)
- ✅ **Yarn 工作区(或项目空间)** (通过 `package.json` (工作区)
- ✅ **npm 工作区** (通过 `package.json` (工作区)
- ✅ **Lerna** (通过 `lerna.json`)

### 示例:单体仓库结构```bash
# Project structure
my-monorepo/
├── packages/
│   ├── app/tsconfig.json
│   ├── server/tsconfig.json
│   ├── db/tsconfig.json
│   └── shared/tsconfig.json
├── pnpm-workspace.yaml
└── tsconfig.base.json

# Auto-detected configs:
# - @myapp/app
# - @myapp/server
# - @myapp/db
# - @myapp/shared

代理可以查询特定的软件包:```
Tool: get_package_diagnostics
Args: { "packageName": "@myapp/server" }


## 性能基准

**场景**4个AI代理在一个TypeScript单体仓库中协作

| 方法 | 时间 | CPU 使用率 | 结果 |
|--------|------|-----------|--------|
| 跑步 `tsc` 直接(4倍)| 总时长约45秒 | 100%峰值 | 系统延迟 |
| 使用 ts-diagnostics-mcp | 首次约2.3秒,缓存后\<50毫秒 | 稳定在\<15% | 运行流畅 |

**性能提升**:

- 类型检查时间(缓存查询)减少95%以上
- CPU使用率降低80%以上
- 为客服人员提供近乎即时的反馈

## 建筑```
┌─────────────────────────────────────────────────┐
│  AI Agents (Claude, GPT, etc.)                  │
│  ┌──────┐  ┌──────┐  ┌──────┐  ┌──────┐       │
│  │Agent1│  │Agent2│  │Agent3│  │Agent4│       │
│  └──┬───┘  └──┬───┘  └──┬───┘  └──┬───┘       │
└─────┼────────┼────────┼────────┼──────────────┘
│        │        │        │
└────────┴────────┴────────┘
│ MCP Protocol
┌────────▼──────────────────┐
│  ts-diagnostics-mcp       │
│  ┌─────────────────────┐  │
│  │   Query Router      │  │
│  │  (Package Filter)   │  │
│  └─────────┬───────────┘  │
│  ┌─────────▼───────────┐  │
│  │  LRU Cache Layer    │  │
│  │  (100MB default)    │  │
│  └─────────┬───────────┘  │
│  ┌─────────▼───────────┐  │
│  │ TypeScript Watch    │  │
│  │ (Compiler API)      │  │
│  └─────────┬───────────┘  │
└────────────┼───────────────┘
│
┌────────────▼───────────────┐
│  TypeScript Source Files   │
│  (Auto-recompiles)         │
└────────────────────────────┘

发展```bash

Install dependencies

pnpm install

Build

pnpm build

Development mode (watch)

pnpm dev

Type check

pnpm typecheck


## 本地测试```bash
# Build the MCP server
cd ts-diagnostics-mcp
npm install
npm run build

# Run directly with your project
node dist/index.js /path/to/your/typescript/project

故障排除

MCP服务器无响应

检查手表进程是否处于活动状态:```
Tool: get_watch_status


### 内存使用率高

减少缓存大小:```bash
export TS_DIAG_MAX_CACHE_SIZE=50

诊断方法已过时

清除缓存以强制刷新:Tool: clear_cache

贡献

欢迎贡献!这是一个开源项目。

  1. 为仓库创建分支
  2. 创建一个特性分支
  3. 进行你的更改
  4. 提交一个拉取请求

许可证

MIT 许可证 - 详见 LICENSE 文件

致谢/鸣谢

构建于:

  • TypeScript 编译器 API
  • 模型上下文协议SDK
  • LRU 缓存

支持

  • 问题: GitHub Issues(GitHub问题)
  • 讨论: GitHub 讨论区

专为使用TypeScript的AI代理打造,倾注爱心

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
Ts Diagnostics MCP 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Ts Diagnostics MCP 怎么在 Claude Desktop、Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Ts Diagnostics MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Ts Diagnostics MCP 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Ts Diagnostics MCP 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Ts Diagnostics MCP 能提供哪些能力?

资料显示能力标签包括 多代理协作、TypeScript、Claude、开发工具。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。