{"id":51026967,"url":"https://github.com/gitstq/snipmcp","last_synced_at":"2026-06-21T20:02:48.095Z","repository":{"id":359924067,"uuid":"1248031432","full_name":"gitstq/snipmcp","owner":"gitstq","description":"🚀 A lightweight, local-first MCP (Model Context Protocol) server for intelligent code snippet management","archived":false,"fork":false,"pushed_at":"2026-05-24T05:15:52.000Z","size":34,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-24T07:11:12.619Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gitstq.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-24T05:09:16.000Z","updated_at":"2026-05-24T05:15:55.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/gitstq/snipmcp","commit_stats":null,"previous_names":["gitstq/snipmcp"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/gitstq/snipmcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fsnipmcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fsnipmcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fsnipmcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fsnipmcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gitstq","download_url":"https://codeload.github.com/gitstq/snipmcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fsnipmcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34623906,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-21T02:00:05.568Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-21T20:02:48.021Z","updated_at":"2026-06-21T20:02:48.085Z","avatar_url":"https://github.com/gitstq.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀 SnipMCP\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eA lightweight, local-first MCP (Model Context Protocol) server for intelligent code snippet management\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#-english\"\u003eEnglish\u003c/a\u003e •\n  \u003ca href=\"#-简体中文\"\u003e简体中文\u003c/a\u003e •\n  \u003ca href=\"#-繁體中文\"\u003e繁體中文\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n\u003ch2 id=\"-english\"\u003e🇺🇸 English\u003c/h2\u003e\n\n### 🎉 Introduction\n\n**SnipMCP** is a lightweight, local-first MCP (Model Context Protocol) server designed for intelligent code snippet management. Unlike cloud-based solutions, SnipMCP stores all your snippets locally using SQLite, ensuring complete privacy and zero latency.\n\n**Key Differentiators:**\n- 🔒 **100% Local** - Your code never leaves your machine\n- ⚡ **Zero Latency** - Instant access to your snippets\n- 🤖 **AI Integration** - Works seamlessly with Claude, Copilot, and other MCP clients\n- 🔍 **Full-Text Search** - Powerful SQLite FTS5 search capabilities\n- 📦 **Zero Dependencies** - Single binary, no external services required\n\n### ✨ Core Features\n\n| Feature | Description |\n|---------|-------------|\n| 💾 **Save Snippets** | Store code with metadata, tags, and descriptions |\n| 🔍 **Smart Search** | Full-text search across names, descriptions, and code |\n| 🏷️ **Tag System** | Organize snippets with flexible tagging |\n| 📊 **Statistics** | Track usage and collection insights |\n| 🌐 **MCP Protocol** | Native integration with AI assistants |\n| 🖥️ **CLI Interface** | Powerful command-line management |\n\n### 🚀 Quick Start\n\n#### Requirements\n- **Node.js** \u003e= 18.0.0\n- **npm** or **yarn**\n\n#### Installation\n\n```bash\n# Install globally\nnpm install -g snipmcp\n\n# Or use directly with npx\nnpx snipmcp --help\n```\n\n#### MCP Client Configuration\n\nAdd SnipMCP to your MCP client (Claude Desktop, Copilot, etc.):\n\n```json\n{\n  \"mcpServers\": {\n    \"snipmcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"snipmcp\"]\n    }\n  }\n}\n```\n\n**For Claude Desktop:**\nEdit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%/Claude/claude_desktop_config.json` (Windows)\n\n### 📖 Usage Guide\n\n#### CLI Commands\n\n```bash\n# Add a new snippet\nsnipmcp add -n \"quick-sort\" -l \"python\" -c \"def quicksort(arr):...\" -d \"Fast sorting algorithm\" -t \"algorithm,sorting\"\n\n# Get a snippet\nsnipmcp get \"quick-sort\"\n\n# Search snippets\nsnipmcp search \"sorting algorithm\"\n\n# List all snippets\nsnipmcp list\n\n# List by language\nsnipmcp list --language python\n\n# Update a snippet\nsnipmcp update \"quick-sort\" --tags \"algorithm,sorting,python\"\n\n# Delete a snippet\nsnipmcp delete \"quick-sort\" --yes\n\n# Show statistics\nsnipmcp stats\n\n# Export/Import\nsnipmcp export backup.json\nsnipmcp import backup.json\n```\n\n#### MCP Tools\n\nWhen connected to an MCP client, SnipMCP provides these tools:\n\n| Tool | Description |\n|------|-------------|\n| `save_snippet` | Save a new code snippet |\n| `get_snippet` | Retrieve a snippet by name |\n| `search_snippets` | Search across all snippets |\n| `list_snippets` | List snippets with filters |\n| `update_snippet` | Modify existing snippets |\n| `delete_snippet` | Remove a snippet |\n| `get_stats` | View collection statistics |\n| `get_languages` | List all languages |\n| `get_tags` | List all tags |\n\n**Example conversation with Claude:**\n\n```\nYou: Save this Python function for later: [code]\nClaude: I'll save that snippet for you. What would you like to name it?\n\nYou: Name it \"fibonacci\" and tag it with \"algorithm,math\"\nClaude: ✅ Snippet saved successfully!\n\nYou: Search for my sorting algorithms\nClaude: I found 3 snippets matching \"sorting\":\n   1. quick-sort (python)\n   2. merge-sort (python)\n   3. heap-sort (java)\n```\n\n### 💡 Design Philosophy\n\n**Why SnipMCP?**\n\n1. **Privacy First**: Unlike cloud-based snippet managers, your code stays on your machine\n2. **AI-Native**: Built for the MCP ecosystem, enabling AI assistants to access your knowledge\n3. **Developer Experience**: Fast CLI, powerful search, and seamless integration\n4. **Future-Proof**: MCP is becoming the standard for AI tool integration\n\n### 📦 Supported Languages\n\n- JavaScript / TypeScript\n- Python\n- Java\n- Go\n- Rust\n- C / C++\n- C#\n- PHP\n- Ruby\n- Swift\n- Kotlin\n- SQL\n- HTML / CSS / SCSS\n- JSON / YAML / XML\n- Markdown\n- Shell / Bash / PowerShell\n- And more...\n\n### 🤝 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n### 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n\u003ch2 id=\"-简体中文\"\u003e🇨🇳 简体中文\u003c/h2\u003e\n\n### 🎉 项目介绍\n\n**SnipMCP** 是一个轻量级、本地优先的 MCP（Model Context Protocol）服务器，专为智能代码片段管理而设计。与基于云的解决方案不同，SnipMCP 使用 SQLite 在本地存储所有代码片段，确保完全的隐私和零延迟。\n\n**核心差异化优势：**\n- 🔒 **100% 本地** - 您的代码永远不会离开您的机器\n- ⚡ **零延迟** - 即时访问您的代码片段\n- 🤖 **AI 集成** - 与 Claude、Copilot 和其他 MCP 客户端无缝协作\n- 🔍 **全文搜索** - 强大的 SQLite FTS5 搜索能力\n- 📦 **零依赖** - 单一二进制文件，无需外部服务\n\n### ✨ 核心特性\n\n| 特性 | 描述 |\n|------|------|\n| 💾 **保存代码片段** | 存储带有元数据、标签和描述的代码 |\n| 🔍 **智能搜索** | 跨名称、描述和代码的全文搜索 |\n| 🏷️ **标签系统** | 使用灵活的标签组织代码片段 |\n| 📊 **统计分析** | 跟踪使用情况和收集洞察 |\n| 🌐 **MCP 协议** | 与 AI 助手原生集成 |\n| 🖥️ **CLI 界面** | 强大的命令行管理工具 |\n\n### 🚀 快速开始\n\n#### 环境要求\n- **Node.js** \u003e= 18.0.0\n- **npm** 或 **yarn**\n\n#### 安装\n\n```bash\n# 全局安装\nnpm install -g snipmcp\n\n# 或直接使用 npx\nnpx snipmcp --help\n```\n\n#### MCP 客户端配置\n\n将 SnipMCP 添加到您的 MCP 客户端（Claude Desktop、Copilot 等）：\n\n```json\n{\n  \"mcpServers\": {\n    \"snipmcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"snipmcp\"]\n    }\n  }\n}\n```\n\n**Claude Desktop 配置：**\n编辑 `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) 或 `%APPDATA%/Claude/claude_desktop_config.json` (Windows)\n\n### 📖 使用指南\n\n#### CLI 命令\n\n```bash\n# 添加新代码片段\nsnipmcp add -n \"quick-sort\" -l \"python\" -c \"def quicksort(arr):...\" -d \"快速排序算法\" -t \"algorithm,sorting\"\n\n# 获取代码片段\nsnipmcp get \"quick-sort\"\n\n# 搜索代码片段\nsnipmcp search \"sorting algorithm\"\n\n# 列出所有代码片段\nsnipmcp list\n\n# 按语言列出\nsnipmcp list --language python\n\n# 更新代码片段\nsnipmcp update \"quick-sort\" --tags \"algorithm,sorting,python\"\n\n# 删除代码片段\nsnipmcp delete \"quick-sort\" --yes\n\n# 显示统计信息\nsnipmcp stats\n\n# 导出/导入\nsnipmcp export backup.json\nsnipmcp import backup.json\n```\n\n#### MCP 工具\n\n连接到 MCP 客户端后，SnipMCP 提供以下工具：\n\n| 工具 | 描述 |\n|------|------|\n| `save_snippet` | 保存新代码片段 |\n| `get_snippet` | 按名称检索代码片段 |\n| `search_snippets` | 搜索所有代码片段 |\n| `list_snippets` | 带过滤器列出代码片段 |\n| `update_snippet` | 修改现有代码片段 |\n| `delete_snippet` | 删除代码片段 |\n| `get_stats` | 查看收集统计信息 |\n| `get_languages` | 列出所有语言 |\n| `get_tags` | 列出所有标签 |\n\n**与 Claude 对话示例：**\n\n```\n您：保存这个 Python 函数供以后使用：[代码]\nClaude：我会为您保存那个代码片段。您想给它起什么名字？\n\n您：命名为 \"fibonacci\"，并标记为 \"algorithm,math\"\nClaude: ✅ 代码片段保存成功！\n\n您：搜索我的排序算法\nClaude: 找到 3 个匹配 \"sorting\" 的代码片段：\n   1. quick-sort (python)\n   2. merge-sort (python)\n   3. heap-sort (java)\n```\n\n### 💡 设计理念\n\n**为什么选择 SnipMCP？**\n\n1. **隐私优先**：与基于云的代码片段管理器不同，您的代码保留在您的机器上\n2. **AI 原生**：为 MCP 生态系统构建，使 AI 助手能够访问您的知识\n3. **开发者体验**：快速 CLI、强大的搜索和无缝集成\n4. **面向未来**：MCP 正在成为 AI 工具集成的标准\n\n### 📦 支持的语言\n\n- JavaScript / TypeScript\n- Python\n- Java\n- Go\n- Rust\n- C / C++\n- C#\n- PHP\n- Ruby\n- Swift\n- Kotlin\n- SQL\n- HTML / CSS / SCSS\n- JSON / YAML / XML\n- Markdown\n- Shell / Bash / PowerShell\n- 更多...\n\n### 🤝 贡献指南\n\n欢迎贡献！请随时提交 Pull Request。\n\n1. Fork 仓库\n2. 创建您的功能分支 (`git checkout -b feature/AmazingFeature`)\n3. 提交您的更改 (`git commit -m 'Add some AmazingFeature'`)\n4. 推送到分支 (`git push origin feature/AmazingFeature`)\n5. 打开 Pull Request\n\n### 📄 开源协议\n\n本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitstq%2Fsnipmcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgitstq%2Fsnipmcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitstq%2Fsnipmcp/lists"}