Espanso MCP服务器
用于管理的MCP（模型上下文协议）服务器 西班牙 文本扩展配置。该服务器允许像Claude这样的人工智能助手与您的Espanso设置进行交互，从而可以轻松创建、更新和管理文本扩展。
Espanso资源：
特性
- 列表 所有匹配文件和扩展
- 创建 具有简单或复杂模式的新文本扩展
- 更新 现有扩建
- 删除 不再需要的扩展
- 模板 用于常见的扩展模式
- 跨平台 支持（Linux、macOS、Windows）
安装
- 克隆此存储库：
git clone https://github.com/bkaes/espanso-mcp.git
cd espanso-mcp- 安装依赖项并构建：
npm install
npm run build- 添加到MCP配置中：
{
"mcpServers": {
"espanso": {
"command": "node",
"args": ["/absolute/path/to/espanso-mcp/dist/index.js"]
}
}
}备注：配置文件位置因平台而异：
- macOS：
~/Library/Application Support/Claude/claude_desktop_config.json - 窗户：
%APPDATA%\Claude\claude_desktop_config.json - Linux：
~/.config/claude/claude_desktop_config.json
用法
配置后，您可以要求Claude：
列出所有扩展
“显示我的所有Espanso文本扩展名”
创建新的扩展
“创建一个Espanso扩展，在我键入：sig时键入我的电子邮件签名”
创建日期扩展
“添加一个扩展名：today，以YYYY-MM-DD格式插入今天的日期”
更新扩展
“更改：sig扩展名以包含我的电话号码”
删除扩展
“从我的Espanso配置中删除：old扩展”
可用工具
list_match_files-列出所有包含扩展名的YAML文件list_matches-显示所有扩展（可选按文件筛选）create_match-添加新的文本扩展update_match-修改现有扩展delete_match-删除扩展get_config_info-显示Espanso配置详细信息generate_documentation-为您的扩展生成markdown文档
文档生成
MCP服务器可以为您的Espanso快捷方式生成全面的文档：
为所有扩展生成文档
“为我的所有Espanso快捷方式创建文档”
为特定文件生成文档
“仅记录我的电子邮件扩展”
文档保存在Espanso配置目录下 docs/ 默认情况下，可以轻松执行以下操作：
- 在扩展中保留文档
- 参考项目README
- 与团队成员分享
模板
服务器为常见的扩展模式提供模板：
- 简单的文本扩展 -基本触发器→ 替换
- 日期扩展 -使用自定义格式动态插入日期
- 表单扩展 -带有用户输入的交互式表单
需求
- Node.js 18或更高版本
- Espanso已安装并配置
发展
在开发模式下运行服务器：
npm run dev项目结构
代码库被组织成模块化组件：
src/index.ts-入口点src/server.ts-MCP服务器实现src/types/-TypeScript接口src/handlers/-每个操作的业务逻辑src/utils/-实用功能
贡献
看 CLAUDE.md 详细的架构和设计决策。
许可证
GPL-3.0