MCP Helper Sublime Plugin

MCPHelper–Sublime文本插件

这是一个Sublime Text插件，可以将您的编辑器连接到本地 模型上下文协议（MCP）服务器，允许您直接在选定的代码上使用OpenAI或Gemini驱动的工具。

🔗 模型上下文协议介绍

______________________________________________________________________

✨ 特性

• 生成代码 从纯文本提示
• 评审代码 错误、安全漏洞或改进
• 重构代码 增强可读性、可维护性和性能
• 翻译代码 在Python、JavaScript、Bash等语言之间。
• 可配置设置 用于MCP服务器URL、超时和模型参数
• 菜单集成 便于访问所有命令
• 稳健的错误处理 带有用户友好的错误消息
• 调试模式 用于故障排除

🖼️ 演示

以下是Sublime Text中插件的外观：

MCP Helper Sublime Demo

______________________________________________________________________

🚀 安装

快速开始

1. 下载插件文件 来自此存储库

1. 复制到您的Sublime Text User软件包文件夹：

- 窗户： %APPDATA%\Sublime Text\Packages\User\ - macOS： ~/Library/Application Support/Sublime Text/Packages/User/ - Linux： ~/.config/sublime-text/Packages/User/

1. 重新启动Sublime Text

1. 配置您的MCP服务器 （见下面的配置部分）

详细安装

有关完整的安装说明，请参阅 安装.md.

______________________________________________________________________

⚙️ 配置

1.MCP服务器设置

确保您的本地MCP服务器正在运行，并且可以在配置的URL上访问（默认值： http://localhost:8000/mcp.json/)

2.插件设置

打开Sublime文本设置：

• 首选 Preferences > Package Settings > MCPHelper > Settings
• 或者直接编辑设置文件

默认设置：

{
  "mcp_server_url": "http://localhost:8000/mcp.json/",
  "timeout_seconds": 120,
  "show_debug_output": false,
  "default_model": "gpt-4o",
  "default_temperature": 0.2,
  "default_max_tokens": 512
}

3.MCP服务器工具

您的MCP服务器应配置以下工具：

@mcp.tool(name="llm_generate_code_openai", description="Generate code using OpenAI")
async def generate_code_openai(params: dict) -> dict:
    # Your OpenAI integration here
    return {"results": [{"data": "generated_code"}]}

______________________________________________________________________

📖 用法

命令面板

1. 在任何文件中选择代码

1. 按 Ctrl+Shift+P

1. 选择以下选项之一：

- MCP: Generate Code - MCP: Review Code - MCP: Refactor Code - MCP: Translate Code

菜单

1. 在任何文件中选择代码
2. 首选 MCP Helper 菜单
3. 选择您想要的行动

键盘快捷键（可选）

添加到密钥绑定文件(Preferences > Key Bindings):

[
  {
    "keys": ["ctrl+shift+g"],
    "command": "mcp_generate_code"
  },
  {
    "keys": ["ctrl+shift+r"],
    "command": "mcp_review_code"
  },
  {
    "keys": ["ctrl+shift+f"],
    "command": "mcp_refactor_code"
  },
  {
    "keys": ["ctrl+shift+t"],
    "command": "mcp_translate_code"
  }
]

______________________________________________________________________

🔧 故障排除

常见问题

1. “无法连接到MCP服务器”

- 确保您的MCP服务器正在运行 - 检查设置中的URL - 验证服务器在配置的端点上是否可访问

1. “MCP工具错误”

- 检查您的MCP服务器日志 - 验证工具名称是否与服务器配置匹配 - 确保在MCP服务器中正确配置了API密钥

1. “未选择文本”

- 在运行命令之前选择一些代码 - 命令需要文本选择才能工作

调试模式

在设置中启用调试输出：

{
  "show_debug_output": true
}

这将在Sublime Text控制台中显示详细的请求/响应信息。

控制台访问

查看调试输出：

1. 首选 View > Show Console
2. 查找以“MCP”开头的消息

______________________________________________________________________

🧩 延伸

您可以通过子类化添加新命令 McpBaseCommand 和定制 build_params():

class McpCustomCommand(McpBaseCommand):
    TOOL_NAME = "your_custom_tool"
    
    def build_params(self, selected_text, extra_input=None):
        return {
            "prompt": f"Custom prompt: {selected_text}",
            "language": "python"
        }

______________________________________________________________________

📄 许可证

该项目根据MIT许可证获得许可。看 许可证 了解详情。

______________________________________________________________________

👤 作者

大卫·多诺霍

旨在以当地优先的心态简化LLM辅助开发。

⚠️ 重要提示： 此插件需要运行 MCP服务器 在您的本地机器上。您必须在MCP服务器中配置自己的OpenAI或Gemini API密钥。该插件不直接处理身份验证或进行API调用，它只需与本地MCP服务器通信即可触发您定义的工具。