Interop是一款功能丰富的命令行工具,用于管理您的项目和自定义命令。其内置的MCP服务器模块允许您将这些本地功能安全、标准地提供给AI助手,增强AI在您的开发工作流中的能力。

主要功能点

  • 项目与命令管理: 通过简单的TOML配置文件定义您的项目(包含路径、描述)和可执行的命令(支持Shell、别名、本地脚本、可执行文件)。
  • AI工具集成: 将配置好的本地命令自动转化为可通过MCP协议被AI助手调用的“工具”。
  • MCP标准支持: 实现JSON-RPC通信(如'mcpGetTools', 'mcpCallTool')和Server-Sent Events (SSE) 事件流,兼容支持MCP协议的AI客户端(如Cursor等)。
  • 守护进程模式: 可在后台以守护进程方式运行MCP服务器,确保AI助手随时可以连接。
  • 配置验证: 提供命令验证功能,确保配置文件的正确性。

安装步骤

目前推荐通过Homebrew安装,确保您已安装Homebrew:

brew install yigitozgumus/formulae/interop

您也可以选择从项目源码自行构建。

MCP服务器配置

MCP服务器的能力主要基于您在 '~/.config/interop/settings.toml' 文件中定义的项目和命令。

AI客户端通常需要知道如何启动MCP服务器以及如何连接到它。以下是可能需要提供给AI客户端的配置信息示例(具体格式和参数名称取决于AI助手):

{
  "name": "Interop MCP Server",
  "description": "Manages local project commands and exposes them as AI tools.",
  "launch_command": ["interop", "mcp", "daemon"],
  "address": "http://localhost:8080",
  "protocol": "http"
}
  • 'name': 此MCP服务器在AI助手界面中的显示名称。
  • 'description': 服务器的简要说明。
  • 'launch_command': 启动MCP服务器守护进程的命令行及其参数。'["interop", "mcp", "daemon"]' 指示AI助手执行 'interop mcp daemon' 命令来启动服务器。
  • 'address': MCP服务器监听的HTTP地址,AI助手将连接到此地址发送JSON-RPC请求和接收SSE事件。默认为 'http://localhost:8080'。
  • 'protocol': 使用的连接协议,这里是HTTP。

请注意,这些配置信息不是您在 'settings.toml' 中设置的内容,而是提供给 AI助手 用于连接Interop MCP服务器的信息。您在 'settings.toml' 中配置的是服务器 暴露 的命令和项目。

基本使用方法

  1. 编辑配置: 使用 'interop edit' 命令打开 '~/.config/interop/settings.toml' 文件,定义您的项目和需要暴露给AI的命令。
  2. 验证配置: 运行 'interop validate' 检查配置文件是否有错误。
  3. 启动服务器: 在终端中执行 'interop mcp start'。这将在后台启动MCP服务器。
  4. 配置AI助手: 根据您使用的AI助手的说明,配置其连接到Interop MCP服务器。通常需要输入上面示例中提供的 'launch_command' 和 'address' 信息。
  5. 使用工具: 在AI助手界面中,您应该能看到Interop服务器暴露的命令作为可用工具。您可以通过AI助手来调用这些工具执行本地任务,例如运行项目构建命令、部署脚本等。
  6. 管理服务器:
    • 'interop mcp status': 查看服务器运行状态和PID。
    • 'interop mcp stop': 停止MCP服务器守护进程。
    • 'interop mcp restart': 重启MCP服务器。
    • 'interop mcp tools list': 列出服务器暴露的MCP工具。
    • 'interop mcp tools commands': 列出服务器暴露的Interop命令。
    • 'interop mcp tools events': 实时查看服务器事件流。

信息

分类

开发者工具