代码生成插件

MCPHelper是一款Sublime Text插件,通过连接本地Model Context Protocol (MCP)服务器,支持在编辑器中直接使用OpenAI或Gemini工具进行代码生成、审查、重构和翻译。

  • by sdirishguy
  • Python
  • 本地部署
  • 8 星标
  • 更新于
在 GitHub 查看 sdirishguy/MCPHelperSublimePlugin

使用说明

MCPHelper–Sublime文本插件

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

🔗 模型上下文协议介绍


✨ 特性

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

🖼️ 演示

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


🚀 安装

快速开始

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

  2. 复制到您的Sublime Text User软件包文件夹:

    • 窗户: %APPDATA%\Sublime Text\Packages\User\
    • macOS: ~/Library/Application Support/Sublime Text/Packages/User/
    • Linux: ~/.config/sublime-text/Packages/User/
  3. 重新启动Sublime Text

  4. 配置您的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. 在任何文件中选择代码

  2. 按 Ctrl+Shift+P

  3. 选择以下选项之一:

    • 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
    • 验证服务器在配置的端点上是否可访问
  2. “MCP工具错误”

    • 检查您的MCP服务器日志
    • 验证工具名称是否与服务器配置匹配
    • 确保在MCP服务器中正确配置了API密钥
  3. “未选择文本”

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

调试模式

在设置中启用调试输出:

{
  "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服务器通信即可触发您定义的工具。