{"id":31447932,"url":"https://github.com/qdrant/mcp-code-snippets","last_synced_at":"2025-10-01T02:14:37.642Z","repository":{"id":306803035,"uuid":"997543419","full_name":"qdrant/mcp-code-snippets","owner":"qdrant","description":null,"archived":false,"fork":false,"pushed_at":"2025-09-15T10:50:40.000Z","size":40,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-09-26T10:49:03.611Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/qdrant.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2025-06-06T17:56:17.000Z","updated_at":"2025-09-15T10:50:44.000Z","dependencies_parsed_at":"2025-07-27T19:09:23.710Z","dependency_job_id":null,"html_url":"https://github.com/qdrant/mcp-code-snippets","commit_stats":null,"previous_names":["qdrant/mcp-code-snippets"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/qdrant/mcp-code-snippets","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qdrant%2Fmcp-code-snippets","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qdrant%2Fmcp-code-snippets/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qdrant%2Fmcp-code-snippets/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qdrant%2Fmcp-code-snippets/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/qdrant","download_url":"https://codeload.github.com/qdrant/mcp-code-snippets/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qdrant%2Fmcp-code-snippets/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":277782799,"owners_count":25876209,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-01T02:00:09.286Z","response_time":88,"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":"2025-10-01T02:14:32.797Z","updated_at":"2025-10-01T02:14:37.636Z","avatar_url":"https://github.com/qdrant.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MCP Code Snippets\n\nThis is an local adapter for MCP server that allows Agents to lookup code snippets in your project.\nLocal MCP implementation allows to auto-fill some arguments for the remote MCP server, and therefore make lookup more accurate. If no results are found with these arguments, results without arguments are returned.\nBy default, it uses Qdrant-maintaned remote MCP server with a collection of code snippets, but you can use your own collection by providing a custom MCP proxy configuration.\n\n## Setup\n\n`mcp-code-snippets` should be available as an executable in your system, so that MCP client (like Cursor) can find it.\n\n### Global installation\n\nSimplest option is to install it globally with `pip`:\n\n```bash\npip install mcp-code-snippets\n```\n\nIn this way it will be available in your system path, and can be used by any MCP client.\n\n\n### Project installation\n\nInstall `mcp-code-snippets` with a package manager of your choice in your project.\n\nAn example using `uv`:\n\n```bash\nuv add mcp-code-snippets\n```\n\n\u003e Note: it might be worth it to install `mcp-code-snippets` as a dev dependency, as it is not needed in production.\n\n### Usage\n\nTo start using `mcp-code-snippets` in your project, you need to configure MCP client to use it.\n\n#### Cursor\n\nAdd the following to your `.cursor/mcp.json` file:\n\n```json\n{\n    \"mcpServers\": {\n        \"mcp-code-snippets\": {\n            \"command\": \"mcp-code-snippets\"\n        }\n    }\n}\n```\n\n### Advanced configuration\n\n`mcp-code-snippest` has one cli argument: --transport, which can be set either to `stdio`, `sse` or `streamable-http`. \nThe default is `stdio`.\nThere is not much other configuration available at the moment, though more to be added.\n\nOther than cli arguments, there are a couple of environment variables to configure the tool:\n`PROJECT_ROOT_PATH` and `MCP_PROXY_CONFIG`.\n\n`PROJECT_ROOT_PATH` is the path to the project root. It is used to detect the programming language of the project, and to extract dependencies.\nThere is an automatic detection of the project language, but you can also specify it manually by setting `PROGRAMMING_LANGUAGE` environment variable.\n\nFor Python supported package managers are those following [PyPA specification](https://packaging.python.org/en/latest/specifications/), `poetry` and `uv` syntax beyond PyPA is also supported. \n\n`MCP_PROXY_CONFIG` is the path to the MCP proxy configuration file, which is used to configure the access to the MCP server with the code snippets.\n\nAn example would be:\n\n```json\n{\n     \"mcpServers\": {\n         \"mcp-server-qdrant\": {\n             \"url\": \"https://mcp.qdrant.tech/mcp/\",\n             \"transport\": \"streamable-http\"\n         }\n     }\n}\n```\n\n#### Editors integrations\n\nYou can use `mcp-code-snippets` with various editors that support MCP protocol.\nAn example configuration for [Cursor](https://www.cursor.com/) in `.cursor/mcp.json` would look like this:\n\n```json\n{\n    \"mcpServers\": {\n        \"mcp-code-snippets\": {\n            \"command\": \"mcp-code-snippets\",\n            \"env\": {\n                \"MCP_PROXY_CONFIG\": \"/home/user/my-mcp/mcp_proxy_example.json\",\n                \"PROJECT_ROOT_PATH\": \"/home/user/my-project\"\n            }\n        }\n    }\n}\n```\n\n`MCP_PROXY_CONFIG` default value is `mcp_proxy.json`, and `PROJECT_ROOT_PATH` defaults to the current directory.\n\n\u003e NOTE: Cursor might not connect to the MCP server with an error like ENOENT mcp-code-snippets, in this case you might need to use absolute paths for all envs and commands.\n\n### Development\n\nThis project uses `uv` for package management and `ruff` for linting and formatting.\nIn order to build the package just run:\n\n```bash\nuv build\n```\n\nAfter building, try running the package with:\n\n```bash\nmcp-code-snippets --help\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqdrant%2Fmcp-code-snippets","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fqdrant%2Fmcp-code-snippets","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqdrant%2Fmcp-code-snippets/lists"}