{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_ey6erg96e8pc","handle":"neo4j-semantic-search-mcp","url":"https://wellknown.network/agents/neo4j-semantic-search-mcp","links":{"self":"https://wellknown.network/agents/neo4j-semantic-search-mcp/record.json","html":"https://wellknown.network/agents/neo4j-semantic-search-mcp","markdown":"https://wellknown.network/agents/neo4j-semantic-search-mcp/record.md","api":"https://wellknown.network/api/v1/agents/neo4j-semantic-search-mcp","status":"https://wellknown.network/api/v1/agents/neo4j-semantic-search-mcp/status","claim":"https://wellknown.network/agents/neo4j-semantic-search-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/neo4j-semantic-search-mcp/claim.json","badge":"https://wellknown.network/agents/neo4j-semantic-search-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:neo4j-semantic-search-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"neo4j-semantic-search-mcp","summary":"MCP server for semantic search in Neo4j knowledge graphs","description":"# Semantic Search MCP Server\n\n**Universal, schema-agnostic** semantic search for **any** Neo4j knowledge graph.\n\nOne tool. Works everywhere. No configuration needed.\n\n## What It Does\n\nSearches across ALL vector indexes in your Neo4j database using semantic similarity. Returns anything that matches your natural language query above a threshold.\n\nWorks with:\n- Any node type\n- Any relationship type\n- Any schema\n- Any knowledge graph with embeddings\n\n## Installation\n\n### 1. Install Dependencies\n\n```bash\npip install -r mcp_servers/semantic_search/requirements.txt\n```\n\n### 2. Configure Environment Variables\n\n```bash\n# Required\nexport OPENAI_API_KEY=\"sk-...\"\nexport NEO4J_PASSWORD=\"your-password\"\n\n# Optional (defaults shown)\nexport NEO4J_URI=\"bolt://localhost:7687\"\nexport NEO4J_USER=\"neo4j\"\nexport EMBEDDING_MODEL=\"text-embedding-3-small\"\n```\n\n### 3. Register with Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS):\n\n```json\n{\n  \"mcpServers\": {\n    \"semantic-search\": {\n      \"command\": \"python\",\n      \"args\": [\"-m\", \"mcp_servers.semantic_search.server\"],\n      \"cwd\": \"/path/to/your/e2r-rd\",\n      \"env\": {\n        \"OPENAI_API_KEY\": \"sk-...\",\n        \"NEO4J_PASSWORD\": \"your-password\"\n      }\n    }\n  }\n}\n```\n\n### 4. Restart Claude Desktop\n\n## Usage\n\n### The Tool: `semantic_search`\n\nOne simple tool with three parameters:\n\n```python\nsemantic_search(\n    query: str,          # Natural language query\n    limit: int = 10,     # Max results (max: 100)\n    threshold: float = 0.7  # Min similarity (0-1)\n)\n```\n\n**Examples:**\n\n```\nsemantic_search(\"database failures\")\nsemantic_search(\"kubernetes scaling\", limit=20)\nsemantic_search(\"cache problems\", threshold=0.8)\n```\n\n**Returns:**\n\n```\nFound 5 results matching 'database failures':\n\n1. **Redis Cache** [Service] (similarity: 0.923) - mentioned 15 times\n2. **PostgreSQL** [Service] (similarity: 0.887) - mentioned 12 times\n3. **cache timeout** [Action] (similarity: 0.845) - mentioned 8 times\n4. **d…","publisher":null,"homepage":null,"repository":null,"version":"0.1.0","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:neo4j-semantic-search-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"data.database","name":"Databases","confidence":1,"provenance":"derived"},{"slug":"data.vector-search","name":"Vector Search","confidence":1,"provenance":"derived"},{"slug":"knowledge.knowledge-graph","name":"Knowledge Graphs","confidence":1,"provenance":"derived"}],"categories":["data","knowledge"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"neo4j-semantic-search-mcp","registry":"pypi","observedAt":"2026-09-10T07:21:51.786Z","publishedAt":"2025-11-06T18:49:35.263342Z","latestVersion":"0.1.0"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"neo4j-semantic-search-mcp","url":"https://pypi.org/project/neo4j-semantic-search-mcp/","firstSeenAt":"2026-09-10T07:21:18.017Z","fetchedAt":"2026-09-10T07:21:18.017Z","normalizedAt":"2026-09-10T07:21:18.017Z"}]},"firstSeenAt":"2026-09-10T07:21:18.017Z","updatedAt":"2026-09-10T07:21:51.786Z"}