CodeMenu MCP

MCP server for CodeMenu snippet manager.

This is a Model Context Protocol (MCP) server that provides integration with the CodeMenu local HTTP API, allowing AI assistants to access and search through code snippets stored in CodeMenu.

The server exposes the following tools for interacting with CodeMenu:

- list_snippets- List snippets without full code content (to reduce token usage). Returns id, title, description, language, abbreviation, tags, and group info. Supports filtering by query, language, tag, or group.
- get_snippet- Retrieve the full details of a specific snippet by ID, including complete code content
- list_tags- List all available tags in CodeMenu
- list_groups- List all available groups in CodeMenu

- CodeMenumust be running on your Mac (Learn more)
- API must be enabledin CodeMenu settings (CodeMenu → Settings → API)
- Node.js >= 18.0.0
- Open CodeMenu
- Go to Settings → API
- Enable the API server
- Note the port (default: 1300)
- Optionally, set an API key for authentication

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

{ "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" } } } }

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

Note: If you didn't enable API key protection in CodeMenu settings, you can omit theCODEMENU_API_KEYenvironment variable.

Once configured, the server will be automatically started by your MCP client (e.g., Claude Desktop). The AI assistant will have access to your CodeMenu snippets and can:

- Browse and search through your code snippets
- Find snippets by language, tags, or groups
- Retrieve specific snippets with full code content when needed
- List available tags and groups for better organization

"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?"

The server communicates over stdio, which is the standard transport for MCP servers.

This validates that the server correctly implements the MCP protocol. To test actual API calls, make sure CodeMenu is running with the API enabled.

- index.js- Main server implementation
- package.json- Project metadata and dependencies
- test.js- MCP protocol test suite
- README.md- This file
- LICENSE- MIT license
- .gitignore- Files to exclude from git

The server implements the Model Context Protocol and exposes tools that correspond to CodeMenu API endpoints:

- GET /snippets- List snippets with optional filters (query, language, tag, group)
- GET /tags- List all tags
- GET /groups- List all groups

For detailed information about the CodeMenu API, refer to theCodeMenu API documentation.

- This MCP server: Open an issue on GitHub
- CodeMenu application or API: Refer to the CodeMenu documentation
- MCP specification: See theModel Context Protocol documentation

Maritime intelligence for tracking vessels, analysing ports, and exploring ship data.