Skip to main content
Glama
ngeojiajun

Code Snippet Server

by ngeojiajun
README.md
# Code Snippet Server

## Overview

Code Snippet Server is a Model Context Protocol (MCP) server designed to manage and store code snippets across different programming languages. It provides a flexible and extensible way to create, list, and delete code snippets using a standardized server interface.

<a href="https://glama.ai/mcp/servers/qt4j367mfk"><img width="380" height="200" src="https://glama.ai/mcp/servers/qt4j367mfk/badge" alt="Code Snippet Server MCP server" /></a>

## Features

- Create code snippets with title, language, and code
- List snippets with optional filtering by language or tag
- Delete snippets by their unique ID
- Localization support
- Persistent local storage

## Prerequisites

- Node.js (18.x, 20.x, or 22.x)
- npm

## Installation

```bash
git clone git@github.com:ngeojiajun/mcp-code-snippets.git
npm run build
npm link
# Or you can do
npx @ngeojiajun/code-snippet-server
```

## Usage

The server exposes three primary tools:

### 1. Create Snippet

Create a new code snippet with a title, language, and code.

Parameters:
- `title` (required): Name of the snippet
- `language` (required): Programming language
- `code` (required): The actual code snippet
- `tags` (optional): Array of tags for categorization

### 2. List Snippets

Retrieve a list of snippets with optional filtering.

Parameters:
- `language` (optional): Filter snippets by programming language
- `tag` (optional): Filter snippets by tag

### 3. Delete Snippet

Remove a snippet from storage.

Parameters:
- `id` (required): Unique identifier of the snippet to delete

## Development

### Build

```bash
npm run build
```

### Lint

```bash
npm run lint
```

## Contributing

Any PRs are welcome

TDQS

B3.2/5.0

Scored across 3 tools

Disambiguation5/5

Each tool has a clearly distinct purpose: create_snippet for creation, delete_snippet for deletion, and list_snippets for listing with optional filtering. There is no overlap or ambiguity between these operations.

Naming Consistency5/5

All tool names follow a consistent verb_noun pattern (create_snippet, delete_snippet, list_snippets) using snake_case throughout. This makes the set predictable and easy to understand.

Tool Count3/5

With only 3 tools, the set feels thin for a snippet management server. While it covers basic operations, it lacks tools for updating snippets or retrieving a single snippet by ID, which are common needs in such domains.

Completeness3/5

The server provides create, delete, and list operations, but there are notable gaps: no update_snippet tool to modify existing snippets and no get_snippet tool to retrieve a specific snippet by ID. This limits functionality and may cause agent workarounds.

Maintenance

ActivityInactive
ResponsivenessNo issues