Jinni MCP服务端测评报告：智能代码上下文提取利器

# 使用pip安装
pip install jinni-mcp

# 或使用uv安装（推荐）
uv add jinni-mcp

# 设置Jinni默认项目路径
[System.Environment]::SetEnvironmentVariable("JINNI_PROJECT_ROOT", "C:\你的项目路径", "User")

{
  "mcpServers": {
    "jinni": {
      "command": "jinni-mcp",
      "args": ["--project-root", "C:\\你的项目路径"]
    }
  }
}

{
  "mcpServers": {
    "jinni": {
      "command": "/Users/你的用户名/Library/Python/3.9/bin/jinni-mcp",
      "args": ["--project-root", "/Users/你的用户名/项目路径"]
    }
  }
}

[Unit]
Description=Jinni MCP Server
After=network.target

[Service]
Type=simple
ExecStart=/home/你的用户名/jinni-env/bin/jinni-mcp --project-root /home/你的用户名/项目路径
Restart=always

[Install]
WantedBy=default.target

{
  "mcpServers": {
    "jinni": {
      "command": "jinni-mcp",
      "args": [
        "--project-root", "/path/to/your/project",
        "--exclude", "**/node_modules/**",
        "--exclude", "**/__pycache__/**"
      ]
    }
  }
}

legacy-ecommerce/
├── src/
│   ├── controllers/
│   ├── models/
│   ├── services/
│   └── utils/
├── config/
├── tests/
└── docs/ (不完整)

{
  "mcpServers": {
    "jinni": {
      "command": "jinni-mcp",
      "args": [
        "--project-root", "./legacy-ecommerce",
        "--include", "**/*.js",
        "--include", "**/*.json",
        "--exclude", "**/node_modules/**",
        "--max-file-size", "500KB"
      ]
    }
  }
}

// 重构后的统一订单服务 - orderService.js
class OrderService {
  constructor(orderRepository, paymentService, inventoryService) {
    this.orderRepository = orderRepository;
    this.paymentService = paymentService;
    this.inventoryService = inventoryService;
  }

  /**
   * 创建订单 - 整合了原来分散在3个文件中的逻辑
   */
  async createOrder(orderData) {
    try {
      // 1. 参数验证 (原来在OrderValidator.js)
      const validationResult = await this.validateOrderData(orderData);
      if (!validationResult.isValid) {
        throw new OrderValidationError(validationResult.errors);
      }

      // 2. 库存检查 (原来在InventoryCheck.js)
      const inventoryAvailable = await this.inventoryService.checkAvailability(
        orderData.items
      );
      if (!inventoryAvailable) {
        throw new InventoryError('商品库存不足');
      }

      // 3. 创建订单记录 (原来在OrderCreator.js)
      const order = await this.orderRepository.create({
        ...orderData,
        status: 'pending',
        createdAt: new Date()
      });

      // 4. 支付处理 (原来在PaymentProcessor.js)
      const paymentResult = await this.paymentService.processPayment({
        orderId: order.id,
        amount: order.totalAmount,
        paymentMethod: orderData.paymentMethod
      });

      // 5. 更新订单状态
      order.status = paymentResult.success ? 'confirmed' : 'payment_failed';
      await this.orderRepository.update(order.id, { status: order.status });

      return {
        success: true,
        order,
        paymentStatus: paymentResult.status
      };
    } catch (error) {
      console.error('订单创建失败:', error);
      return {
        success: false,
        error: error.message
      };
    }
  }

  /**
   * 统一的订单验证方法
   */
  async validateOrderData(orderData) {
    const errors = [];
    
    // 商品验证
    if (!orderData.items || orderData.items.length === 0) {
      errors.push('订单商品不能为空');
    }

    // 金额验证
    if (orderData.totalAmount <= 0) {
      errors.push('订单金额必须大于0');
    }

    // 用户信息验证
    if (!orderData.userId) {
      errors.push('用户ID不能为空');
    }

    return {
      isValid: errors.length === 0,
      errors
    };
  }
}

module.exports = OrderService;

// orderService.test.js
const OrderService = require('./orderService');
const MockOrderRepository = require('../mocks/orderRepository');
const MockPaymentService = require('../mocks/paymentService');

describe('OrderService', () => {
  let orderService;
  let mockOrderRepo;
  let mockPaymentService;

  beforeEach(() => {
    mockOrderRepo = new MockOrderRepository();
    mockPaymentService = new MockPaymentService();
    orderService = new OrderService(mockOrderRepo, mockPaymentService);
  });

  test('应该成功创建有效订单', async () => {
    const orderData = {
      userId: 'user123',
      items: [{ productId: 'prod1', quantity: 2 }],
      totalAmount: 99.99,
      paymentMethod: 'credit_card'
    };

    const result = await orderService.createOrder(orderData);

    expect(result.success).toBe(true);
    expect(result.order.status).toBe('confirmed');
  });
});