Development MCP Server

TypeScript提取器MCP服务器

用于提取TypeScript导入和方法体的MCP（模型上下文协议）服务器。此工具作为具有身份验证的HTTP服务器运行，并提供从TypeScript文件中提取特定方法/函数及其相关导入和类属性的工具。

特性

• 基于HTTP的MCP服务器：使用流式HTTP传输进行有状态通信
• 认证：通过客户端注册进行承载令牌身份验证
• 列表方法工具：发现TypeScript文件中的所有方法/函数
• 提取方法工具：提取方法及其依赖关系
• 读取文件工具：读取整个文件内容
• 智能导入过滤：仅返回实际使用的项目相关导入
• 类别属性提取：从方法的类和引用的类中提取属性
• 综合方法检测：处理类方法（实例和静态）、独立函数、箭头函数和接口/类型方法签名
• 纯文本输出：返回可读代码，导入、属性和方法体之间有明确的分隔

建筑

这是一个基于HTTP的MCP服务器，它：

• 在可配置端口上运行（默认值：4001）
• 需要客户端注册才能进行身份验证
• 使用承载令牌实现API安全
• 将令牌持久化 .mcp-tokens.json

安装

npm install
npm run build

运行服务器

npm start

服务器将在端口4001上启动。您可以自定义端口：

PORT=3000 npm start

快速开始

1.启动服务器

npm start

2.注册客户

curl -X POST http://localhost:4001/register \
  -H "Content-Type: application/json" \
  -d '{"clientId": "my-client"}'

保存返回的令牌。

3.列出文件中的方法

curl -X POST http://localhost:4001/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "list_typescript_methods",
      "arguments": {"filePath": "test-examples/sample.ts"}
    }
  }'

4.提取方法

curl -X POST http://localhost:4001/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "extract_typescript_method",
      "arguments": {
        "filePath": "test-examples/sample.ts",
        "methodName": "fetchUser"
      }
    }
  }'

API终点

可用工具

list_typescript_methods

列出TypeScript文件中的所有方法和函数名。

参数：

• filePath （string，必填）：TypeScript文件的路径

例子：

curl -X POST http://localhost:4001/mcp \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "list_typescript_methods",
      "arguments": {"filePath": "src/app.ts"}
    }
  }'

extract_typescript_method

提取一个方法/函数及其相关的导入和类属性。

参数：

• filePath （string，必填）：TypeScript文件的路径
• methodName （string，必填）：要提取的方法/函数的名称

例子：

curl -X POST http://localhost:4001/mcp \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "extract_typescript_method",
      "arguments": {
        "filePath": "src/app.ts",
        "methodName": "handleRequest"
      }
    }
  }'

输出格式：

Method Name: handleRequest
File Path: src/app.ts
Line Number: 45

Imports:
import { helper } from './utils';

Properties/Constants:
private config: Config;
static MAX_RETRIES = 3;

Method Body:
async handleRequest(req: Request): Promise {
  // method body
}

read_file

读取并返回文件的全部内容。

参数：

• filePath （string，必填）：文件路径

例子：

curl -X POST http://localhost:4001/mcp \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "read_file",
      "arguments": {"filePath": "src/app.ts"}
    }
  }'

输出格式：

[Full file contents]

支持的TypeScript构造

• 类方法（实例方法）
• 静态类方法
• 独立函数声明
• 分配给变量的箭头函数
• 分配给变量的函数表达式
• 接口方法签名
• 类型别名方法签名

发展

# Watch mode for development
npm run watch

# Build for production
npm run build

# Run tests
npm test

运作原理

1. 解析：用途 ts-morph 将TypeScript文件解析为AST
2. 定位：在所有支持的构造中查找请求的方法
3. 分析：标识方法体中使用的所有标识符
4. 筛选器导入：仅返回与项目相关的导入(./, ../, src/)使用
5. 提取属性：对于类方法，从类和引用的类中提取属性
6. 格式：返回包含导入、属性和方法体的结构化输出

用例

• 学习与探索：快速了解具体方法的工作原理及其所依赖的内容
• 代码审查：提取方法及其依赖关系，以便进行重点审查
• 文档：生成示例，显示具有所需导入的方法实现
• 重构：在将代码移动到不同文件之前，请查看确切的依赖关系
• 代码导航：列出文件中的所有方法以了解其结构

项目结构

context-tree/
├── src/
│   ├── index.ts           # MCP HTTP server
│   └── extractor.ts       # TypeScript extraction logic
├── test-examples/
│   ├── sample.ts          # Example TypeScript file
│   └── test-extractor.ts  # Test script
├── build/                 # Compiled JavaScript
├── package.json
├── tsconfig.json
└── .mcp-tokens.json       # Stored authentication tokens

依赖项

• @modelcontextprotocol/sdk：MCP协议实施
• ts-morph：TypeScript AST操作
• express：Web服务器
• zod：架构验证

文档

• QUICKSTART.md -几分钟内起床跑步
• USAGE.md -带示例的详细使用指南
• PROJECT_SUMMARY.md -架构和技术细节

许可证

麻省理工学院