ts语言mcp
](https://www.npmjs.com/package/ts-language-mcp)  ](https://github.com/jgauffin/ts-language-mcp/issues) ](https://github.com/jgauffin/ts-language-mcp/stargazers)
通过MCP(模型上下文协议)为AI编码代理提供TypeScript代码智能服务器。
为什么使用这个?
使用TypeScript的AI编码代理将代码视为文本——读取整个文件,查找模式,猜测类型。 ts语言mcp 通过MCP工具公开TypeScript自己的编译器智能:
| 原始文件访问 | ts语言mcp |
|---|---|
| 读取整个文件以查找函数 | 直接跳转到定义 |
| 查找使用模式 | 获取所有具有读/写分类的引用 |
| 从上下文猜测类型 | 获取具有完整泛型解析的精确类型 |
| 希望重命名不会破坏东西 | 跨文件预览和执行重命名 |
与基于LSP的替代方案不同,ts-language-mcp直接使用TypeScript编译器API-零配置、更深层次的智能(AST搜索、批处理分析、可执行文件重命名、项目范围诊断),并且不需要外部LSP服务器。
快速开始
# Analyze current directory
npx ts-language-mcp
# Analyze specific project
npx ts-language-mcp /path/to/typescript/project
# Custom server name
npx ts-language-mcp --name my-ts-server /path/to/projectMCP客户端配置
克劳德代码:
claude mcp add typescript -- npx ts-language-mcp /path/to/your/projectClaude Desktop、Cline等:
{
"mcpServers": {
"typescript": {
"command": "npx",
"args": ["ts-language-mcp", "/path/to/your/project"]
}
}
}目标项目需要 tsconfig.json 以及TypeScript源文件。服务器自动加载编译器选项并监视文件更改。
资源
typescript://project/files-列出所有索引项目文件typescript://project/config-当前编译器选项typescript://file/{path}-读取文件内容
工具
| 类别 | 工具 | 描述 |
|---|---|---|
| 导航 | get_definition | 从使用跳转到声明 |
get_references | 查找具有读/写分类的所有用法 | |
get_implementations | 查找接口的具体实现 | |
get_call_hierarchy | 跟踪函数调用者/被调用者 | |
get_type_hierarchy | 导航继承链 | |
| 类型智能 | get_hover | 在某个位置键入信息和JSDoc |
get_signature | 函数参数帮助 | |
| 代码结构 | get_symbols | 文件中的符号平面列表 |
get_outline | 分层文件结构 | |
get_imports | 列出所有导入的详细信息 | |
| 语义搜索 | find | 按名称模式、种类、范围进行AST搜索 |
get_workspace_symbols | 快速模糊符号搜索 | |
| 诊断 | get_diagnostics | 文件的错误/警告 |
get_all_diagnostics | 项目范围内的诊断 | |
get_completions | 上下文感知完成 | |
| 重构 | rename_preview | 预览重命名影响 |
rename_symbol | 跨项目执行重命名 | |
format_document | 使用内置格式化程序进行格式化 | |
| 效率 | analyze_position | 一次通话中的综合分析 |
batch_analyze | 同时分析多个职位 |
发展
npm test # Run tests (watch)
npm run test:run # Run tests once
npm run build # Build
npm run dev # Watch mode建筑
src/
index.ts # CLI entry point
server.ts # MCP server setup
language-service.ts # TypeScript Language Service wrapper
ast-finder.ts # AST traversal for semantic search
tools.ts # MCP tool definitions and handlers
resources.ts # MCP resource definitions
types.ts # Shared type definitions许可证
麻省理工学院
