MCPHelper–Sublime文本插件
这是一个Sublime Text插件，可以将您的编辑器连接到本地 模型上下文协议（MCP）服务器，允许您直接在选定的代码上使用OpenAI或Gemini驱动的工具。
______________________________________________________________________
✨ 特性
- 生成代码 从纯文本提示
- 评审代码 错误、安全漏洞或改进
- 重构代码 增强可读性、可维护性和性能
- 翻译代码 在Python、JavaScript、Bash等语言之间。
- 可配置设置 用于MCP服务器URL、超时和模型参数
- 菜单集成 便于访问所有命令
- 稳健的错误处理 带有用户友好的错误消息
- 调试模式 用于故障排除
🖼️ 演示
以下是Sublime Text中插件的外观：
______________________________________________________________________
🚀 安装
快速开始
- 下载插件文件 来自此存储库
- 复制到您的Sublime Text User软件包文件夹：
- 窗户： %APPDATA%\Sublime Text\Packages\User\ - macOS： ~/Library/Application Support/Sublime Text/Packages/User/ - Linux： ~/.config/sublime-text/Packages/User/
- 重新启动Sublime Text
- 配置您的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"}]}______________________________________________________________________
📖 用法
命令面板
- 在任何文件中选择代码
- 按
Ctrl+Shift+P
- 选择以下选项之一：
- MCP: Generate Code - MCP: Review Code - MCP: Refactor Code - MCP: Translate Code
菜单
- 在任何文件中选择代码
- 首选
MCP Helper菜单 - 选择您想要的行动
键盘快捷键（可选）
添加到密钥绑定文件(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"
}
]______________________________________________________________________
🔧 故障排除
常见问题
- “无法连接到MCP服务器”
- 确保您的MCP服务器正在运行 - 检查设置中的URL - 验证服务器在配置的端点上是否可访问
- “MCP工具错误”
- 检查您的MCP服务器日志 - 验证工具名称是否与服务器配置匹配 - 确保在MCP服务器中正确配置了API密钥
- “未选择文本”
- 在运行命令之前选择一些代码 - 命令需要文本选择才能工作
调试模式
在设置中启用调试输出：
{
"show_debug_output": true
}这将在Sublime Text控制台中显示详细的请求/响应信息。
控制台访问
查看调试输出：
- 首选
View > Show Console - 查找以“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服务器通信即可触发您定义的工具。