Codemenu MCP

代码菜单mcp

用于CodeMenu代码段管理器的MCP服务器。

概述

这是一个模型上下文协议（MCP）服务器，提供与CodeMenu本地HTTP API的集成，允许AI助手访问和搜索存储在CodeMenu中的代码片段。

特性

服务器公开了以下用于与CodeMenu交互的工具：

• list_snippets -列出没有完整代码内容的代码段（以减少令牌使用）。返回id、标题、描述、语言、缩写、标签和组信息。支持按查询、语言、标记或组进行筛选。
• get_snippet -按ID检索特定代码段的全部详细信息，包括完整的代码内容
• list_tags -在CodeMenu中列出所有可用标签
• list_groups -在CodeMenu中列出所有可用组

先决条件

• 代码菜单 必须在Mac上运行(了解更多)
• 必须启用API 在CodeMenu设置中（CodeMenu→ 设置→ API)
• Node.js>=18.0.0

代码菜单API设置

1. 打开代码菜单
2. 转到“设置”→ API
3. 启用API服务器
4. 注意端口（默认值：1300）
5. （可选）设置用于身份验证的API密钥

CodeMenu API在本地运行 http://127.0.0.1:1300/v1 默认情况下。

安装

来自npm（发布时）

npm install -g git+https://github.com/Extiri/codemenu-mcp.git

来源

git clone https://github.com/Extiri/codemenu-mcp.git
cd codemenu-mcp
npm install
npm link

配置

服务器连接到本地CodeMenu API，并支持以下环境变量：

环境变量

• CODEMENU_API_URL -CodeMenu API的基本URL（默认值： http://127.0.0.1:1300/v1)
• CODEMENU_API_KEY -您的CodeMenu API键

Claude桌面配置示例

将此添加到您的Claude Desktop配置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

视窗: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "codemenu": {
      "command": "node",
      "args": ["/path/to/codemenu-mcp/index.js"],
      "env": {
        "CODEMENU_API_URL": "http://127.0.0.1:1300/v1",
        "CODEMENU_API_KEY": "your-api-key"
      }
    }
  }
}

或者通过npm全局安装：

{
  "mcpServers": {
    "codemenu": {
      "command": "codemenu-mcp",
      "env": {
        "CODEMENU_API_KEY": "your-api-key"
      }
    }
  }
}

备注：如果未在CodeMenu设置中启用API密钥保护，则可以省略 CODEMENU_API_KEY 环境变量。

用法

配置后，服务器将由您的MCP客户端（例如Claude Desktop）自动启动。AI助手将可以访问您的CodeMenu片段，并可以：

• 浏览和搜索您的代码片段
• 按语言、标签或组查找片段
• 需要时检索包含完整代码内容的特定代码段
• 列出可用的标签和组，以便更好地组织

交互示例

搜索片段：

"Search my CodeMenu snippets for sorting algorithms"

按语言列出代码片段：

"Show me all my JavaScript snippets from CodeMenu"

获取特定片段：

"Show me the full code for snippet ID ABC123"

列表标签：

"What tags do I have in CodeMenu?"

发展

运行服务器

npm start

服务器通过stdio进行通信，这是MCP服务器的标准传输方式。

测试

npm test

这验证了服务器正确实现了MCP协议。要测试实际的API调用，请确保CodeMenu在启用API的情况下运行。

项目结构

• index.js -主服务器实现
• package.json -项目元数据和依赖关系
• test.js -MCP协议测试套件
• README.md -此文件
• LICENSE -MIT许可证
• .gitignore -从git中排除的文件

API 参考

服务器实现模型上下文协议，并公开与CodeMenu API端点对应的工具：

• GET /snippets -列出带有可选筛选器（查询、语言、标记、组）的代码段
• GET /tags -列出所有标签
• GET /groups -列出所有组

有关CodeMenu API的详细信息，请参阅 CodeMenu API文档.

需求

• Node.js>=18.0.0
• 启用API的CodeMenu应用程序
• MCP客户端（如克劳德桌面）

许可证

麻省理工学院

贡献

欢迎投稿！请随时提交拉取请求。

支持

关于以下问题：

• 此MCP服务器：在GitHub上打开一个问题
• CodeMenu应用程序或API：请参阅CodeMenu文档
• MCP规格：见 模型上下文协议文档

故障排除

服务器无法连接到CodeMenu：

• 确保CodeMenu应用程序正在运行
• 检查在CodeMenu设置中是否启用了API
• 验证端口是否与您的配置匹配（默认值：1300）
• 如果您启用了API密钥保护，请确保 CODEMENU_API_KEY 设置正确

未返回代码片段：

• 验证CodeMenu中是否有代码段
• 检查您的搜索筛选器是否限制过多
• 尝试先列出不带过滤器的列表

身份验证错误：

• 检查是否 CODEMENU_API_KEY 环境变量设置正确