Token导航 LogoToken导航TokenDH.com
Sublime MCP logo
运维云端stdio官方级别未说明来源级核验

Sublime MCP

MCP Server

MCPServer是一个Sublime Text插件,通过本地HTTP暴露MCP工具,用于管理未保存的缓冲区,支持列出、读取和关闭缓冲区等操作。

工具数

3

提示词数

0

GitHub Stars

1

资源数

0
PythonHTTP服务云端部署

安装说明

本站只整理中文说明和来源信息,不托管安装包,也不代用户安装。

作者 / 组织

benyue1978

提供方

benyue1978

最后核验

2026/5/17 20:22

运行时

Python

快速接入

先看主来源和安装命令,再打开仓库或文档;下面只保留这个条目的关键接入事实。

命令预览

python3 scripts/build_release.py

详细介绍

MCP服务器

MCPServer 是一个Sublime Text包,它通过本地HTTP从Sublime的Python运行库中公开MCP工具。

今天,它附带了用于未保存缓冲区的MCP工具:

  • list_open_buffers
  • read_buffer
  • close_buffer

用例

  • 直接从打开的未保存选项卡中读取临时草稿或提示。
  • 在AI客户端中总结或细化草稿,然后将结果发送给另一个MCP,如Notion。
  • 通过关闭消耗的划痕缓冲区来清理工作标签 close_buffer.
  • 构建轻量级编辑器自动化,而无需将一次性笔记保存到磁盘。

架构完全在进程中。默认情况下,它会启动:

  • 崇高的桥梁 127.0.0.1:6123
  • MCP端点打开 127.0.0.1:6124/mcp

不需要单独的Node或TypeScript MCP服务器。

需求

  • Sublime Text 4版本 4171 或更新版本
  • 插件包与Python 3.8的兼容性
  • 如果你想在本地运行repo测试,请使用Python 3.11+
  • 可以与可流式传输的HTTP MCP端点通信的本地MCP客户端

项目布局

  • sublime_mcp_server/:桥接逻辑和进程内MCP HTTP服务器
  • sublime_mcp_server_plugin.py:Sublime Text插件入口点
  • messages.jsonmessages/*.txt:包控制安装和升级消息
  • python_tests/:桥接和MCP行为的pytest覆盖率

安装Sublime插件

正常使用时,将打包好的工件安装到Sublime的 Installed Packages 文件夹。

在macOS上:

mkdir -p "$HOME/Library/Application Support/Sublime Text/Installed Packages"
cp dist/MCPServer.sublime-package \
  "$HOME/Library/Application Support/Sublime Text/Installed Packages/MCPServer.sublime-package"

如果您之前安装了未打包的开发副本,请先将其删除,这样Sublime就不会加载该包两次:

rm -rf "$HOME/Library/Application Support/Sublime Text/Packages/MCPServer"

复制文件后重新启动Sublime Text。

打包版本包括存储库的跟踪 .python版本 文件位于包根目录,这样Sublime在加载存档时可以选择正确的Python运行时。

对于本地开发,您仍然可以在下使用解包结账 Packages/MCPServer,但现在这是一个仅用于开发的工作流程,而不是推荐的安装方法。

端口配置

该包从以下位置读取其主机和端口配置 MCPServer配置.

默认值:

{
  "bridge_host": "127.0.0.1",
  "bridge_port": 6123,
  "mcp_host": "127.0.0.1",
  "mcp_port": 6124
}

要在Sublime文本中覆盖它们:

  1. 打开命令选项板。
  2. Preferences: MCPServer Settings.
  3. 将您的覆盖放在右侧的用户设置窗格中。
  4. 重新启动Sublime Text。

例子:

{
  "bridge_port": 7001,
  "mcp_port": 7002
}

使用同一主机时,网桥和MCP端口必须不同。

包装和发布

Sublime Text软件包有两种常见的发布路径:

  • 包控制默认通道:在GitHub上发布此仓库,创建语义版本标签,如 0.2.5,并将存储库提交给包控制一次。批准后,未来的semver标签是用户接收更新的方式。
  • 自定义分发:构建一个 .sublime-package 存档并托管您自己的 packages.json 如果您不想使用包控件的默认通道,请使用通道。

此仓库现在包括面向发布的元数据:

建议发布清单:

  1. 更新中的版本 pyproject.tomlsublime_mcp服务器/__初始化__南美国家巴拉圭的缩写(Paraguay).
  2. 在下面添加匹配的升级说明 messages/.
  3. 建立一个 .sublime-package repo根目录中的工件:
python3 scripts/build_release.py
  1. pytestpython3 -m py_compile sublime_mcp_server_plugin.py sublime_mcp_server/*.py.
  2. 提交发布更改。
  3. 创建并推送一个semver标签,例如 0.2.5.
  4. 如果这是第一次公开发布,请将GitHub存储库URL提交给包控制。

对于手动安装,请使用生成的 dist/MCPServer.sublime-package 文件。稳定的文件名使Sublime中的包名保持干净,构建器注入 package-metadata.json 因此描述和版本在包UI中可见。

验证插件是否正在运行

一旦Sublime重新启动,插件应启动两个本地主机服务:

  • GET http://127.0.0.1:6123/buffers
  • POST http://127.0.0.1:6124/mcp

检查桥:

curl -sf http://127.0.0.1:6123/buffers | python3 -m json.tool

检查MCP端点:

curl -sf \
  -X POST http://127.0.0.1:6124/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"probe","version":"1.0.0"}}}' \
  | python3 -m json.tool

你应该看看 serverInfo.name 着手 sublime_mcp_server.

如果在设置中更改了端口,请使用这些值,而不是 61236124.

MCP客户端设置

此项目从Sublime内部通过HTTP为MCP提供服务,因此您的MCP客户端只需连接到插件的端点。

建议的MCP客户端配置:

{
  "mcpServers": {
    "sublime_mcp_server": {
      "type": "http",
      "url": "http://127.0.0.1:6124/mcp"
    }
  }
}

可用工具

list_open_buffers

列出未保存的打开的Sublime缓冲区。每个缓冲区描述符包括:

  • buffer_id
  • title
  • window_id
  • is_dirty
  • syntax
  • preview

read_buffer

读取一个未保存的Sublime缓冲区的当前实时文本和元数据。

输入:

{
  "buffer_id": "38"
}

close_buffer

强制关闭未保存的Sublime缓冲区并丢弃其当前内容。

输入:

{
  "buffer_id": "38"
}

手动端到端检查

  1. 打开Sublime文本。
  2. 创建一个或多个新的未保存选项卡。
  3. 添加一些测试文本。
  4. 验证缓冲区列表:
curl -sf http://127.0.0.1:6123/buffers | python3 -m json.tool
  1. 使用MCP客户端或直接JSON-RPC请求列出工具并读取缓冲区。

直接JSON-RPC示例:

curl -sf \
  -X POST http://127.0.0.1:6124/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}' \
  | python3 -m json.tool
curl -sf \
  -X POST http://127.0.0.1:6124/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"read_buffer","arguments":{"buffer_id":"38"}}}' \
  | python3 -m json.tool
curl -sf \
  -X POST http://127.0.0.1:6124/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"close_buffer","arguments":{"buffer_id":"38"}}}' \
  | python3 -m json.tool

发展

运行测试:

pytest

检查语法:

python3 -m py_compile sublime_mcp_server_plugin.py sublime_mcp_server/*.py

目录标签

目录标签

PythonHTTP服务云端部署SublimeText插件本地部署缓冲区管理文本编辑工具

接入字段

传输方式(transport,传输协议)

stdio

鉴权方式(authType,认证方式)

none

运行时(runtime,运行环境)

Python

工具数量(toolCount,工具数)

3

资源数量(resourceCount,资源数)

0

提示词数量(promptCount,提示词数)

0

权限和风险

stdionone部署方式未说明

接入前请确认传输方式、认证方式和部署位置,并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限;先核对安装命令和配置内容。

来源信息

继续浏览同类 MCP