{"_id":"@ruvector/rvf-mcp-server","_rev":"13-3c765c874090632c60f37d0f9f6a1b49","name":"@ruvector/rvf-mcp-server","dist-tags":{"latest":"0.2.5"},"versions":{"0.1.0":{"name":"@ruvector/rvf-mcp-server","version":"0.1.0","keywords":["rvf","ruvector","mcp","vector-database","model-context-protocol"],"license":"MIT","_id":"@ruvector/rvf-mcp-server@0.1.0","maintainers":[{"name":"ruvnet","email":"ruv@ruv.net"}],"bin":{"rvf-mcp-server":"dist/cli.js"},"dist":{"shasum":"368287aa597b037ef6831438c5563d4db229ff7b","tarball":"https://registry.npmjs.org/@ruvector/rvf-mcp-server/-/rvf-mcp-server-0.1.0.tgz","fileCount":7,"integrity":"sha512-NRm/I1iHB2r7WXuWny2vPpUz/t6BjITlnTueetDN8HU4vBOp/1oCKIjKa4nb4J3M1DRUNjAx5WKun2P4hTw6ew==","signatures":[{"sig":"MEUCIQDUw2EAVAqXZaUdLWCBhVtRdxR8JVdFRBz4kRBwWCxhpwIgRzm6zMOPE2ZGjUBxGqH3FS7UCl5FUCvZabpmCHWl3GU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":28733},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"ed833918f20ebbd289f9a94a1dc1a5cf63d23155","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/cli.js","start:sse":"node dist/cli.js --transport sse --port 3100","start:stdio":"node dist/cli.js --transport stdio"},"_npmUser":{"name":"ruvnet","email":"ruv@ruv.net"},"_npmVersion":"9.8.1","description":"MCP server for RuVector Format (RVF) vector database — stdio and SSE transports","directories":{},"_nodeVersion":"22.21.1","dependencies":{"zod":"^3.22.0","express":"^4.18.0","@ruvector/rvf":"workspace:*","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.0","@types/node":"^20.10.0","@types/express":"^4.17.21"},"_npmOperationalInternal":{"tmp":"tmp/rvf-mcp-server_0.1.0_1771087061022_0.3807204636268162","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@ruvector/rvf-mcp-server","version":"0.1.1","keywords":["rvf","ruvector","mcp","vector-database","model-context-protocol"],"license":"MIT","_id":"@ruvector/rvf-mcp-server@0.1.1","maintainers":[{"name":"ruvnet","email":"ruv@ruv.net"}],"bin":{"rvf-mcp-server":"dist/cli.js"},"dist":{"shasum":"8f63f605254386b919774daddc2031044869e3f4","tarball":"https://registry.npmjs.org/@ruvector/rvf-mcp-server/-/rvf-mcp-server-0.1.1.tgz","fileCount":9,"integrity":"sha512-lIikGAKB+RDxoIu+D1Wn8+yWhFGbI81EuBE3c+OCpM1cx5C5ADlRReN3+1PkjIBIblsnz5am7Dyh2OVMzhU2GA==","signatures":[{"sig":"MEQCIGNyJI4ThVdKkT0MgqMAoRBK0yQAkojqKLnu1ER0VB4fAiBJqQnZgoI/Nw354JW5ZqsEyH7lS+QYnfOXoYXsWz6RXw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":28873},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"fb6bd64685c6467947977180b77816511f61793e","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/cli.js","start:sse":"node dist/cli.js --transport sse --port 3100","start:stdio":"node dist/cli.js --transport stdio"},"_npmUser":{"name":"ruvnet","email":"ruv@ruv.net"},"_npmVersion":"9.8.1","description":"MCP server for RuVector Format (RVF) vector database — stdio and SSE transports","directories":{},"_nodeVersion":"22.21.1","dependencies":{"zod":"^3.22.0","express":"^4.18.0","@ruvector/rvf":"^0.1.2","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.0","@types/node":"^20.10.0","@types/express":"^4.17.21"},"_npmOperationalInternal":{"tmp":"tmp/rvf-mcp-server_0.1.1_1771114187747_0.03772807690626312","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@ruvector/rvf-mcp-server","version":"0.1.2","keywords":["rvf","ruvector","mcp","vector-database","model-context-protocol"],"license":"MIT","_id":"@ruvector/rvf-mcp-server@0.1.2","maintainers":[{"name":"ruvnet","email":"ruv@ruv.net"}],"bin":{"rvf-mcp-server":"dist/cli.js"},"dist":{"shasum":"28dfb776e6023070673f67744abd35a60aa94e8a","tarball":"https://registry.npmjs.org/@ruvector/rvf-mcp-server/-/rvf-mcp-server-0.1.2.tgz","fileCount":9,"integrity":"sha512-U78ns0X6vJuC6a1TUUZaiZQeqQn0Xlt4jUrEPK3ilpRQ026n2BEWFttMg4N4KSRWAiLsyEvkLVnOux9IVRjy6A==","signatures":[{"sig":"MEQCIHLDo2YhLv+n25niTVzssIcweAfmQshBRMaoZWEujnxoAiAQ33IEa19ahgY41Av9vYtnG2TlO7DCpMzH7HUF6ZYbfg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":28873},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"e9a697a0f474190670f9ef248f1b16be4c09b7eb","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/cli.js","start:sse":"node dist/cli.js --transport sse --port 3100","start:stdio":"node dist/cli.js --transport stdio"},"_npmUser":{"name":"ruvnet","email":"ruv@ruv.net"},"_npmVersion":"9.8.1","description":"MCP server for RuVector Format (RVF) vector database — stdio and SSE transports","directories":{},"_nodeVersion":"22.21.1","dependencies":{"zod":"^3.22.0","express":"^4.18.0","@ruvector/rvf":"^0.1.2","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.0","@types/node":"^20.10.0","@types/express":"^4.17.21"},"_npmOperationalInternal":{"tmp":"tmp/rvf-mcp-server_0.1.2_1771137011755_0.5103272487182888","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@ruvector/rvf-mcp-server","version":"0.1.3","keywords":["rvf","ruvector","mcp","vector-database","model-context-protocol"],"license":"MIT","_id":"@ruvector/rvf-mcp-server@0.1.3","maintainers":[{"name":"ruvnet","email":"ruv@ruv.net"}],"bin":{"rvf-mcp-server":"dist/cli.js"},"dist":{"shasum":"05f92be9061cfc605c06791ca51b4054b6df4129","tarball":"https://registry.npmjs.org/@ruvector/rvf-mcp-server/-/rvf-mcp-server-0.1.3.tgz","fileCount":9,"integrity":"sha512-UO4U7dS2Le7d8WX0zG97ZmcjUfpJxG+sPfuwwJh2DDlLvyOHTb02cz7SMS/SMdwItF6Nia4Yp1//L30TVYJZag==","signatures":[{"sig":"MEUCIQDZXDtHPHgCxl2B1dN7O/CemSwIaEv4gi5e5QzS4d1pMQIgWgmjLW4KOyqqZ54Qa8e0YP3xHS/yMS8zCXRNNmuv5LU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":28949},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"9fb3d2c63b19ac6950b931f4adb56834bf96c45d","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/cli.js","start:sse":"node dist/cli.js --transport sse --port 3100","start:stdio":"node dist/cli.js --transport stdio"},"_npmUser":{"name":"ruvnet","email":"ruv@ruv.net"},"_npmVersion":"9.8.1","description":"MCP server for RuVector Format (RVF) vector database — stdio and SSE transports","directories":{},"_nodeVersion":"22.21.1","dependencies":{"zod":"^3.22.0","express":"^4.18.0","@ruvector/rvf":"^0.1.2","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.0","@types/node":"^20.10.0","@types/express":"^4.17.21"},"_npmOperationalInternal":{"tmp":"tmp/rvf-mcp-server_0.1.3_1771252450685_0.401606150974964","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@ruvector/rvf-mcp-server","version":"0.1.4","keywords":["rvf","ruvector","mcp","vector-database","model-context-protocol"],"license":"MIT","_id":"@ruvector/rvf-mcp-server@0.1.4","maintainers":[{"name":"ruvnet","email":"ruv@ruv.net"}],"bin":{"rvf-mcp-server":"dist/cli.js"},"dist":{"shasum":"bb90e2167f5980caf77cdf6f49f51804815d2e43","tarball":"https://registry.npmjs.org/@ruvector/rvf-mcp-server/-/rvf-mcp-server-0.1.4.tgz","fileCount":21,"integrity":"sha512-YZFcvwy0t2IyqonujDJMlH3E0f8UeuMwtZAgQa+738+y6fNbCGwoqSDOv5vEA/JX/nfZVmVwergj6HJ4Uel5qg==","signatures":[{"sig":"MEYCIQDjScpEi2qJ98KUp6x7chgOMYWLJPwk/t08B7F31ZgcmgIhAMp6DIGjObpsakzi6qfRRxgBDS6FGrbToy/EVbWIljlw","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":78558},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"3e0b5723dae57aa24540b76a4cb3c75d111e9f89","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/cli.js","start:sse":"node dist/cli.js --transport sse --port 3100","start:stdio":"node dist/cli.js --transport stdio"},"_npmUser":{"name":"ruvnet","email":"ruv@ruv.net"},"_npmVersion":"9.8.1","description":"MCP server for RuVector Format (RVF) vector database — stdio and SSE transports","directories":{},"_nodeVersion":"22.21.1","dependencies":{"zod":"^3.22.0","express":"^4.18.0","@ruvector/rvf":"^0.1.2","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.0","@types/node":"^20.10.0","@types/express":"^4.17.21"},"_npmOperationalInternal":{"tmp":"tmp/rvf-mcp-server_0.1.4_1774451910900_0.9834462627916587","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"name":"@ruvector/rvf-mcp-server","version":"0.1.5","keywords":["rvf","ruvector","mcp","vector-database","model-context-protocol"],"license":"MIT","_id":"@ruvector/rvf-mcp-server@0.1.5","maintainers":[{"name":"ruvnet","email":"ruv@ruv.net"}],"bin":{"rvf-mcp-server":"dist/cli.js"},"dist":{"shasum":"4bff6c0b770fa35b27ceb258e65891e95efec2e6","tarball":"https://registry.npmjs.org/@ruvector/rvf-mcp-server/-/rvf-mcp-server-0.1.5.tgz","fileCount":18,"integrity":"sha512-Z76j7bXWfnBn9yXsQU94gAwU/jdV9/AoVVRVmYKC2ijYYozgrQtMvQBFwsY2ic3DqKZ5YtlOCE79IEyGzxp47w==","signatures":[{"sig":"MEUCIEasScAnfUon0atWwsLsGovVuKioivekW2hSTVNUe7COAiEAzF2QWWFH7cgs8aA6GijEx5QijW3dYYOb8bD4xIxLNZU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIHTRq9+g4BJoNt/bj2yxqs24N29ZV6DpURCepgaWNjBZAiEAg3y7r442RNh3fmp9aOfuND5l1+GE6+EpjMpJhtN7Qv8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":87948},"main":"dist/index.js","type":"module","_from":"file:/home/ruvultra/.cache/claude-code/tmp/claude-1000/-home-ruvultra-projects-ruvector/44859da8-9824-486d-ae11-16bc65ad0b35/scratchpad/ruvector-rvf-mcp-server-0.1.5.tgz","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"dev":"tsc --watch","test":"tsc && node --test --test-force-exit test/server.test.mjs test/sse.test.mjs","build":"tsc","start":"node dist/cli.js","start:sse":"node dist/cli.js --transport sse --port 3100","start:stdio":"node dist/cli.js --transport stdio"},"_npmUser":{"name":"ruvnet","email":"ruv@ruv.net"},"_resolved":"/home/ruvultra/.cache/claude-code/tmp/claude-1000/-home-ruvultra-projects-ruvector/44859da8-9824-486d-ae11-16bc65ad0b35/scratchpad/ruvector-rvf-mcp-server-0.1.5.tgz","_integrity":"sha512-Z76j7bXWfnBn9yXsQU94gAwU/jdV9/AoVVRVmYKC2ijYYozgrQtMvQBFwsY2ic3DqKZ5YtlOCE79IEyGzxp47w==","_npmVersion":"10.9.8","description":"MCP server for RuVector Format (RVF) vector database — stdio and SSE transports","directories":{},"_nodeVersion":"22.23.2","dependencies":{"zod":"^4.6.7","express":"^4.18.0","@modelcontextprotocol/sdk":"^1.32.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.0","@types/node":"^20.10.0","@types/express":"^4.17.21"},"_npmOperationalInternal":{"tmp":"tmp/rvf-mcp-server_0.1.5_1793814366488_0.5918894158535178","host":"s3://npm-registry-packages-npm-production"}},"0.1.6":{"name":"@ruvector/rvf-mcp-server","version":"0.1.6","keywords":["rvf","ruvector","mcp","vector-database","model-context-protocol"],"license":"MIT","_id":"@ruvector/rvf-mcp-server@0.1.6","maintainers":[{"name":"ruvnet","email":"ruv@ruv.net"}],"bin":{"rvf-mcp-server":"dist/cli.js"},"dist":{"shasum":"cf84d20ffb5adc35a72293d961be57d92ff0629b","tarball":"https://registry.npmjs.org/@ruvector/rvf-mcp-server/-/rvf-mcp-server-0.1.6.tgz","fileCount":18,"integrity":"sha512-QfaleNsQU7ctT/ST11hniXsM7zEcaqt/+eD6RdoIt/8Zcz7pj/DgHpjhIASW4qqI40Kfqq6lsBYHS/weHEO5hg==","signatures":[{"sig":"MEQCIC/QnmELyhF8xfE9f7aDv5VQ0ABiTHwf2i7sGDsvx8PrAiAOzhjIE6KGHS2c9qcamdYYbOTncOE7Sb9uVM0GAoziJQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQDqXMVzeGHwqZx5hj5D9qBq6MEY1OoJ4ky6GIOoLVUXbQIhAIlcetLMMYmsjLPWP5TR3xGVkB3RaHXcxi8lF38d1FY3","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":88216},"main":"dist/index.js","type":"module","_from":"file:/home/ruvultra/.cache/claude-code/tmp/claude-1000/-home-ruvultra-projects-ruvector/44859da8-9824-486d-ae11-16bc65ad0b35/scratchpad/new/ruvector-rvf-mcp-server-0.1.6.tgz","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"dev":"tsc --watch","test":"tsc && node --test --test-force-exit test/server.test.mjs test/sse.test.mjs","build":"tsc","start":"node dist/cli.js","start:sse":"node dist/cli.js --transport sse --port 3100","start:stdio":"node dist/cli.js --transport stdio"},"_npmUser":{"name":"ruvnet","email":"ruv@ruv.net"},"_resolved":"/home/ruvultra/.cache/claude-code/tmp/claude-1000/-home-ruvultra-projects-ruvector/44859da8-9824-486d-ae11-16bc65ad0b35/scratchpad/new/ruvector-rvf-mcp-server-0.1.6.tgz","_integrity":"sha512-QfaleNsQU7ctT/ST11hniXsM7zEcaqt/+eD6RdoIt/8Zcz7pj/DgHpjhIASW4qqI40Kfqq6lsBYHS/weHEO5hg==","_npmVersion":"10.9.8","description":"MCP server for RuVector Format (RVF) vector database — stdio and SSE transports","directories":{},"_nodeVersion":"22.23.2","dependencies":{"zod":"^4.6.7","express":"^4.18.0","@modelcontextprotocol/sdk":"^1.32.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.0","@types/node":"^20.10.0","@types/express":"^4.17.21"},"_npmOperationalInternal":{"tmp":"tmp/rvf-mcp-server_0.1.6_1793825671645_0.7509655534457436","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@ruvector/rvf-mcp-server","version":"0.2.0","keywords":["rvf","ruvector","mcp","vector-database","model-context-protocol"],"license":"MIT","_id":"@ruvector/rvf-mcp-server@0.2.0","maintainers":[{"name":"ruvnet","email":"ruv@ruv.net"}],"bin":{"rvf-mcp-server":"dist/cli.js"},"dist":{"shasum":"6c41da1bb02ba5836ba0f814df60d9f905b82cab","tarball":"https://registry.npmjs.org/@ruvector/rvf-mcp-server/-/rvf-mcp-server-0.2.0.tgz","fileCount":22,"integrity":"sha512-hd/eHN8/ASm140XSOos0wHmA5RmTlWT4J3ZT1SWYvT9JGrnaXlufVQkA2GbdaLpF3TqYQREjY48j6amipQzKBA==","signatures":[{"sig":"MEUCICkLpbtctRFeD03Y93zdtZkozNZpZC2+4Ja689zX6rqaAiEAq0rLDmXq+r0ucmxYJvn0+MpgTKdInYzjFBAsL3LdfKs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCICywNYaFkiOtMzvKXuo/yevYmsomw8W1KI+3vmyDTp09AiEAobryTBERksZ7r9lROqYolgRdsX3f9PGA0Ec/LhgbDs4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":119072},"main":"dist/index.js","type":"module","_from":"file:/home/ruvultra/.cache/claude-code/tmp/claude-1000/-home-ruvultra-projects-ruvector/44859da8-9824-486d-ae11-16bc65ad0b35/scratchpad/rel-rvf-final/ruvector-rvf-mcp-server-0.2.0.tgz","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"dev":"tsc --watch","test":"tsc && node --test --test-force-exit test/server.test.mjs test/sse.test.mjs","build":"tsc","start":"node dist/cli.js","start:sse":"node dist/cli.js --transport sse --port 3100","start:stdio":"node dist/cli.js --transport stdio"},"_npmUser":{"name":"ruvnet","email":"ruv@ruv.net"},"_resolved":"/home/ruvultra/.cache/claude-code/tmp/claude-1000/-home-ruvultra-projects-ruvector/44859da8-9824-486d-ae11-16bc65ad0b35/scratchpad/rel-rvf-final/ruvector-rvf-mcp-server-0.2.0.tgz","_integrity":"sha512-hd/eHN8/ASm140XSOos0wHmA5RmTlWT4J3ZT1SWYvT9JGrnaXlufVQkA2GbdaLpF3TqYQREjY48j6amipQzKBA==","_npmVersion":"10.9.8","description":"MCP server for RuVector Format (RVF) vector database — stdio and SSE transports","directories":{},"_nodeVersion":"22.23.2","dependencies":{"zod":"^4.6.7","express":"^4.18.0","@ruvector/rvf":"^0.4.3","@modelcontextprotocol/sdk":"^1.32.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.0","@types/node":"^20.10.0","@types/express":"^4.17.21"},"_npmOperationalInternal":{"tmp":"tmp/rvf-mcp-server_0.2.0_1793957385391_0.979194381474252","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@ruvector/rvf-mcp-server","version":"0.2.1","keywords":["rvf","ruvector","mcp","vector-database","model-context-protocol"],"license":"MIT","_id":"@ruvector/rvf-mcp-server@0.2.1","maintainers":[{"name":"ruvnet","email":"ruv@ruv.net"}],"bin":{"rvf-mcp-server":"dist/cli.js"},"dist":{"shasum":"9783e056475a010ebf031eb67c5d5bf3c7915e4f","tarball":"https://registry.npmjs.org/@ruvector/rvf-mcp-server/-/rvf-mcp-server-0.2.1.tgz","fileCount":22,"integrity":"sha512-GVPyeSUWI3gWxZh82naVHEYErCDU9E8LPDPciKZVRhmHm6u9Hzdj+SIBlhBLuU3C67c+nTkfi1wwBfuji510EQ==","signatures":[{"sig":"MEUCIDbLjyviKUG/EMl0TrbsD6l67iZ39FN2yl2O+mCqsMZrAiEArRrkm4oKtGlMO9CYO260trybIJtKegBKEUsjSNzF1gc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIEZ905iGdcq6VEfrLiNDqDGDb2zonrclkM0547QI1q8BAiBp15KmQkZr+ZmHOAB4ap+hRjVYxbVFIOvw6PH74hOFNQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":119123},"main":"dist/index.js","type":"module","_from":"file:/home/ruvultra/.cache/claude-code/tmp/claude-1000/-home-ruvultra-projects-ruvector/44859da8-9824-486d-ae11-16bc65ad0b35/scratchpad/rel-rvf045/ruvector-rvf-mcp-server-0.2.1.tgz","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"dev":"tsc --watch","test":"tsc && node --test --test-force-exit test/server.test.mjs test/sse.test.mjs","build":"tsc","start":"node dist/cli.js","start:sse":"node dist/cli.js --transport sse --port 3100","start:stdio":"node dist/cli.js --transport stdio"},"_npmUser":{"name":"ruvnet","email":"ruv@ruv.net"},"_resolved":"/home/ruvultra/.cache/claude-code/tmp/claude-1000/-home-ruvultra-projects-ruvector/44859da8-9824-486d-ae11-16bc65ad0b35/scratchpad/rel-rvf045/ruvector-rvf-mcp-server-0.2.1.tgz","_integrity":"sha512-GVPyeSUWI3gWxZh82naVHEYErCDU9E8LPDPciKZVRhmHm6u9Hzdj+SIBlhBLuU3C67c+nTkfi1wwBfuji510EQ==","_npmVersion":"10.9.8","description":"MCP server for RuVector Format (RVF) vector database — stdio and SSE transports","directories":{},"_nodeVersion":"22.23.2","dependencies":{"zod":"^4.6.7","express":"^4.18.0","@ruvector/rvf":"^0.4.5","@modelcontextprotocol/sdk":"^1.32.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.0","@types/node":"^20.10.0","@types/express":"^4.17.21"},"_npmOperationalInternal":{"tmp":"tmp/rvf-mcp-server_0.2.1_1793964102004_0.2859585981917808","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@ruvector/rvf-mcp-server","version":"0.2.2","keywords":["rvf","ruvector","mcp","vector-database","model-context-protocol"],"license":"MIT","_id":"@ruvector/rvf-mcp-server@0.2.2","maintainers":[{"name":"ruvnet","email":"ruv@ruv.net"}],"bin":{"rvf-mcp-server":"dist/cli.js"},"dist":{"shasum":"64d15219808182f4922d3168252e4c2132833ad3","tarball":"https://registry.npmjs.org/@ruvector/rvf-mcp-server/-/rvf-mcp-server-0.2.2.tgz","fileCount":22,"integrity":"sha512-3bkhX0l0+kuhdth5/XgC5BtXQQ2avn7XjfR59CyEbB8wpymrwFzhp2GaUL4qdO0gJiUIFfVFst8lBS10Wt3sEA==","signatures":[{"sig":"MEUCIQDk57KPLvmUy6L04+ch5qI5riymRWjr6i6KbCf8Ndl+RwIgZrmvO96WoohfEWUhbSmd3H6R2FPgXvOZYPdXoLsEXW0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQCkYQD9Ny3vScNgp7VSdPEuQgnrgwr0dstl85658+YqmwIgTje7E0qndx2aLL5/xS7R67wFD9EgbbhqZAgiocsZooI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":119123},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"dev":"tsc --watch","test":"tsc && node --test --test-force-exit test/server.test.mjs test/sse.test.mjs","build":"tsc","start":"node dist/cli.js","start:sse":"node dist/cli.js --transport sse --port 3100","start:stdio":"node dist/cli.js --transport stdio"},"_npmUser":{"name":"ruvnet","email":"ruv@ruv.net"},"_npmVersion":"10.9.8","description":"MCP server for RuVector Format (RVF) vector database — stdio and SSE transports","directories":{},"_nodeVersion":"22.23.2","dependencies":{"zod":"^4.6.7","express":"^4.18.0","@ruvector/rvf":"^0.4.8","@modelcontextprotocol/sdk":"^1.32.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.0","@types/node":"^20.10.0","@types/express":"^4.17.21"},"_npmOperationalInternal":{"tmp":"tmp/rvf-mcp-server_0.2.2_1794189961436_0.4932124025586543","host":"s3://npm-registry-packages-npm-production"}},"0.2.3":{"name":"@ruvector/rvf-mcp-server","version":"0.2.3","keywords":["mcp","mcp-server","model-context-protocol","vector-search","vector-database","embeddings","rag","ai-agents","claude-code","typescript","ruvector","rvf"],"license":"MIT","_id":"@ruvector/rvf-mcp-server@0.2.3","maintainers":[{"name":"ruvnet","email":"ruv@ruv.net"}],"homepage":"https://ruv.io","bugs":{"url":"https://github.com/ruvnet/RuVector/issues"},"bin":{"rvf-mcp-server":"dist/cli.js"},"dist":{"shasum":"4eb0312d0b1d48fde0dae1138593f27c2cdaa268","tarball":"https://registry.npmjs.org/@ruvector/rvf-mcp-server/-/rvf-mcp-server-0.2.3.tgz","fileCount":22,"integrity":"sha512-f7THHC/qzuiGlkjhYUBGWLqHeS1jzIFWwvF7qLXmwUGUu/EXhrCiUOY0Jn43Q3Sz8E+gSAxt2/liPjPcYgA/Nw==","signatures":[{"sig":"MEUCIQDkMKhXPtPTkzWle1CV6l7RcJ69MG8uCBntlK8t6e0wpAIgdjTUuZR1kcjHuLxR9ZqzAWIq3R+ED3IqvmnBI7Uokjc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQC3Eh3UO/p2bCNgynYpZQmzrbo3aJH6MfUu2pR4L2iMfAIgEGW7AA2ZeRshMq+yB8lphC+v1BXDwHIbmDD0WF69AT0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":129007},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"dev":"tsc --watch","test":"tsc && node --test --test-force-exit test/server.test.mjs test/sse.test.mjs","build":"tsc","start":"node dist/cli.js","start:sse":"node dist/cli.js --transport sse --port 3100","start:stdio":"node dist/cli.js --transport stdio"},"_npmUser":{"name":"ruvnet","email":"ruv@ruv.net"},"repository":{"url":"git+https://github.com/ruvnet/RuVector.git","type":"git","directory":"npm/packages/rvf-mcp-server"},"_npmVersion":"10.9.8","description":"MCP server for local vector search over portable RVF files: Claude Code, Cursor and other MCP clients create, fill and query HNSW-indexed .rvf stores over stdio or SSE.","directories":{},"_nodeVersion":"22.23.2","dependencies":{"zod":"^4.6.7","express":"^4.18.0","@ruvector/rvf":"^0.4.8","@modelcontextprotocol/sdk":"^1.32.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.0","@types/node":"^20.10.0","@types/express":"^4.17.21"},"_npmOperationalInternal":{"tmp":"tmp/rvf-mcp-server_0.2.3_1794199341951_0.2626091313350052","host":"s3://npm-registry-packages-npm-production"}},"0.2.4":{"name":"@ruvector/rvf-mcp-server","version":"0.2.4","keywords":["mcp","mcp-server","model-context-protocol","vector-search","vector-database","embeddings","rag","ai-agents","claude-code","typescript","ruvector","rvf"],"license":"MIT","_id":"@ruvector/rvf-mcp-server@0.2.4","maintainers":[{"name":"ruvnet","email":"ruv@ruv.net"}],"homepage":"https://ruv.io","bugs":{"url":"https://github.com/ruvnet/RuVector/issues"},"bin":{"rvf-mcp-server":"dist/cli.js"},"dist":{"shasum":"94f75c433803dd530e9994618cf83abf940cec77","tarball":"https://registry.npmjs.org/@ruvector/rvf-mcp-server/-/rvf-mcp-server-0.2.4.tgz","fileCount":22,"integrity":"sha512-Jowa1X9w6e+9eHrqSUiF9VhhWp7PLZAbYk5uSx0dgQPj2/x2kN7lXtSuHcR2ANfSko6e6lQevJ03OoG58dc+7w==","signatures":[{"sig":"MEUCIQCcw3VFHYl332A0wm+0qgXZw2wilHQHn/Wx1zOwguolXgIgHZqhpUkxGF/NU66sVXvhAW7Q/SZbzcqesxED2+L89DM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIG2XOBdZq6jQ/Rugo83YrQ3KoQGSEWRmxNvog6Gu+zRjAiAfjREsH+UOslrbpkmNRwDscNIfvbq6x/9ZIdOQWKj8gw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":137356},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"dev":"tsc --watch","test":"tsc && node --test --test-force-exit test/server.test.mjs test/sse.test.mjs","build":"tsc","start":"node dist/cli.js","start:sse":"node dist/cli.js --transport sse --port 3100","start:stdio":"node dist/cli.js --transport stdio"},"_npmUser":{"name":"ruvnet","email":"ruv@ruv.net"},"repository":{"url":"git+https://github.com/ruvnet/RuVector.git","type":"git","directory":"npm/packages/rvf-mcp-server"},"_npmVersion":"10.9.8","description":"MCP server for local vector search over portable RVF files: Claude Code, Cursor and other MCP clients create, fill and query HNSW-indexed .rvf stores over stdio or SSE.","directories":{},"_nodeVersion":"22.23.2","dependencies":{"zod":"^4.6.7","express":"^4.18.0","@ruvector/rvf":"^0.4.8","@modelcontextprotocol/sdk":"^1.32.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.0","@types/node":"^20.10.0","@types/express":"^4.17.21"},"_npmOperationalInternal":{"tmp":"tmp/rvf-mcp-server_0.2.4_1794207540480_0.8098722204394946","host":"s3://npm-registry-packages-npm-production"}},"0.2.5":{"_id":"@ruvector/rvf-mcp-server@0.2.5","bin":{"rvf-mcp-server":"dist/cli.js"},"bugs":{"url":"https://github.com/ruvnet/RuVector/issues"},"dist":{"shasum":"6c273bdc77c8b95b6d0867376a8fd3721383a8fc","tarball":"https://registry.npmjs.org/@ruvector/rvf-mcp-server/-/rvf-mcp-server-0.2.5.tgz","fileCount":22,"integrity":"sha512-S4ZCb9RkugnfQu4bWDgpeW5uEVzUC6xanrw6VVfBCDGWuWzFauBWENGeKBU9JiMtfiUZW8KeJzfE6il0RmBEEA==","signatures":[{"sig":"MEUCIHZqzT0iNh5xLgTu/QC1YHA53kBpYL143h6GRfBp3fVvAiEAgHGP9ynb/PkrGXWbJ62Rv+g0G8c4uil8FG9ddo6qjYk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDna/5iSTez8SqX2dXlwAZui68Co00ienqkWG4Oy7f6IQIgaYlZYdFcdLbYqnIb2ICrMWIMJx/YsqZX5pEnibJojFE="}],"unpackedSize":137356},"main":"dist/index.js","name":"@ruvector/rvf-mcp-server","type":"module","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"license":"MIT","scripts":{"dev":"tsc --watch","test":"tsc && node --test --test-force-exit test/server.test.mjs test/sse.test.mjs","build":"tsc","start":"node dist/cli.js","start:sse":"node dist/cli.js --transport sse --port 3100","start:stdio":"node dist/cli.js --transport stdio"},"version":"0.2.5","_npmUser":{"name":"ruvnet","email":"ruv@ruv.net"},"homepage":"https://ruv.io","keywords":["mcp","mcp-server","model-context-protocol","vector-search","vector-database","embeddings","rag","ai-agents","claude-code","typescript","ruvector","rvf"],"repository":{"url":"git+https://github.com/ruvnet/RuVector.git","type":"git","directory":"npm/packages/rvf-mcp-server"},"_npmVersion":"10.9.8","description":"MCP server for local vector search over portable RVF files: Claude Code, Cursor and other MCP clients create, fill and query HNSW-indexed .rvf stores over stdio or SSE.","directories":{},"maintainers":[{"name":"ruvnet","email":"ruv@ruv.net"}],"_nodeVersion":"22.23.2","dependencies":{"zod":"^4.6.7","express":"^4.22.3","@ruvector/rvf":"^0.4.8","@modelcontextprotocol/sdk":"^1.32.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.0","@types/node":"^20.10.0","@types/express":"^4.17.21"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/rvf-mcp-server_0.2.5_1794252412711_0.012663922766304014"}}},"time":{"created":"2026-02-14T16:37:40.905Z","modified":"2026-11-09T19:26:53.011Z","0.1.0":"2026-02-14T16:37:41.149Z","0.1.1":"2026-02-15T00:09:47.903Z","0.1.2":"2026-02-15T06:30:11.898Z","0.1.3":"2026-02-16T14:34:10.823Z","0.1.4":"2026-03-25T15:18:31.043Z","0.1.5":"2026-11-04T17:46:06.577Z","0.1.6":"2026-11-04T20:54:31.720Z","0.2.0":"2026-11-06T09:29:45.476Z","0.2.1":"2026-11-06T11:21:42.105Z","0.2.2":"2026-11-09T02:06:01.522Z","0.2.3":"2026-11-09T04:42:22.045Z","0.2.4":"2026-11-09T06:59:00.579Z","0.2.5":"2026-11-09T19:26:52.810Z"},"bugs":{"url":"https://github.com/ruvnet/RuVector/issues"},"license":"MIT","homepage":"https://ruv.io","keywords":["mcp","mcp-server","model-context-protocol","vector-search","vector-database","embeddings","rag","ai-agents","claude-code","typescript","ruvector","rvf"],"repository":{"url":"git+https://github.com/ruvnet/RuVector.git","type":"git","directory":"npm/packages/rvf-mcp-server"},"description":"MCP server for local vector search over portable RVF files: Claude Code, Cursor and other MCP clients create, fill and query HNSW-indexed .rvf stores over stdio or SSE.","maintainers":[{"name":"ruvnet","email":"ruv@ruv.net"}],"readme":"<p align=\"center\"><img src=\"https://raw.githubusercontent.com/ruvnet/RuVector/main/assets/ruvector/packages/rvf-mcp-server.svg\" alt=\"@ruvector/rvf-mcp-server: MCP server for RuVector Format vector stores — stdio and SSE transports for AI agents.\" width=\"100%\"></p>\n\n# @ruvector/rvf-mcp-server\n\nLocal vector search for AI agents over MCP: this server lets Claude Code, Cursor or any Model Context Protocol client open a portable `.rvf` vector index on your disk and run k-nearest-neighbor search against its HNSW index, with no hosted database and no API key.\n\nIt is the MCP front end for [`@ruvector/rvf`](https://www.npmjs.com/package/@ruvector/rvf), the library that writes and reads `.rvf` files. Build an index with `@ruvector/rvf` (or with this server's `rvf_create_store` / `rvf_ingest` tools), then search it from any MCP client.\n\n## Supported environments\n\n- **Node.js** >= 18 (`engines`). The quickstart below was run on Node 20.x, 22.23 and 24.22 on Linux x64.\n- **OS / CPU**: the server always opens stores through the native `@ruvector/rvf-node` binding, which ships prebuilt binaries for Linux x64 and arm64 (glibc), macOS x64 and arm64, and Windows x64. There is no prebuilt binary for Alpine/musl or 32-bit platforms.\n- **No WASM fallback in the server.** `@ruvector/rvf` itself installs an optional `@ruvector/rvf-wasm` backend for browsers and in-memory use, but this server needs real files on disk and does not fall back to it. On a platform without a native binary, opening a store fails.\n\n## Quickstart: search a portable RVF index through MCP\n\n```bash\nmkdir rvf-mcp-demo && cd rvf-mcp-demo\nnpm init -y\nnpm install @ruvector/rvf-mcp-server @ruvector/rvf @modelcontextprotocol/sdk\n```\n\n`@ruvector/rvf` and `@modelcontextprotocol/sdk` are already dependencies of the server; listing them lets the two scripts import them directly and adds nothing to the install.\n\n**1. Build an index.** Save as `build-index.mjs`:\n\n```js\n// build-index.mjs: write a small portable RVF index to stores/docs.rvf\nimport { RvfDatabase } from '@ruvector/rvf';\nimport { mkdirSync } from 'node:fs';\n\nconst docs = [\n  { id: 'intro-to-rvf', vector: [0.9, 0.1, 0.0, 0.0] },\n  { id: 'hnsw-explained', vector: [0.7, 0.6, 0.1, 0.0] },\n  { id: 'mcp-tools', vector: [0.0, 0.2, 0.9, 0.1] },\n  { id: 'claude-code-setup', vector: [0.1, 0.0, 0.8, 0.5] },\n  { id: 'cooking-pasta', vector: [0.0, 0.0, 0.1, 0.99] },\n];\n\nmkdirSync('stores', { recursive: true });\nconst db = await RvfDatabase.create('stores/docs.rvf', { dimensions: 4, metric: 'cosine' });\nconst { accepted } = await db.ingestBatch(\n  docs.map((d) => ({ id: d.id, vector: new Float32Array(d.vector) })),\n);\nawait db.close();\nconsole.log(`wrote stores/docs.rvf with ${accepted} vectors`);\n```\n\nIn a real index the vectors come from your embedding model; four dimensions keep the example readable.\n\n**2. Search it through the MCP server.** Save as `search.mjs`. It starts the server over stdio, exactly as an MCP client would, and calls the `rvf_open_store` and `rvf_query` tools:\n\n```js\n// search.mjs: start rvf-mcp-server over stdio and search stores/docs.rvf through MCP\nimport { Client } from '@modelcontextprotocol/sdk/client/index.js';\nimport { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';\nimport { fileURLToPath } from 'node:url';\nimport { resolve } from 'node:path';\n\nconst cli = fileURLToPath(new URL('./cli.js', import.meta.resolve('@ruvector/rvf-mcp-server')));\nconst transport = new StdioClientTransport({\n  command: process.execPath,\n  args: [cli, '--data-dir', resolve('stores')],\n});\nconst client = new Client({ name: 'rvf-quickstart', version: '1.0.0' });\nawait client.connect(transport);\n\nasync function call(name, args) {\n  const res = await client.callTool({ name, arguments: args });\n  const text = res.content[0].text;\n  if (text.startsWith('Error:')) throw new Error(`${name}: ${text}`);\n  return JSON.parse(text);\n}\n\nconst store = await call('rvf_open_store', { path: 'docs.rvf', readOnly: true });\nconsole.log(`opened ${store.path}: ${store.dimensions} dims, ${store.metric}`);\nconst { results } = await call('rvf_query', {\n  storeId: store.storeId,\n  vector: [0.05, 0.1, 0.85, 0.3], // \"how do I set up MCP in Claude Code?\"\n  k: 3,\n});\nfor (const [i, r] of results.entries()) {\n  console.log(`${i + 1}. ${r.id.padEnd(18)} distance=${r.distance.toFixed(4)}`);\n}\nawait client.close();\n```\n\n**3. Run both:**\n\n```bash\nnode build-index.mjs\nnode search.mjs\n```\n\nExpected output (the `RVF MCP Server starting` line is the server's banner on stderr):\n\n```text\nwrote stores/docs.rvf with 5 vectors\nRVF MCP Server starting (stdio transport)...\nopened docs.rvf: 4 dims, cosine\n1. claude-code-setup  distance=0.0310\n2. mcp-tools          distance=0.0324\n3. cooking-pasta      distance=0.5773\n```\n\nResults are ranked by distance, closest first. For `cosine` the distance is `1 - cosine similarity`.\n\n**Moving an index.** Copy every `<store>.rvf*` file together. `@ruvector/rvf` keeps string ids in a `<store>.rvf.idmap.json` sidecar, so an index built directly with it (like `docs.rvf` above) and moved without that sidecar answers with numeric ids. Metadata filters (`filter` on `rvf_query`) use the server's own `<store>.rvf.mcp-meta.jsonl`, so they apply to vectors ingested through the server's `rvf_ingest` tool, not to an index built elsewhere.\n\nSince 0.2.4 the server also writes each vector's string id into the `.rvf` itself, as the native metadata field `rvf_mcp_id`. A store written by the server therefore still returns, and filters by, its original ids when only `<store>.rvf` and `<store>.rvf.mcp-meta.jsonl` were copied. If a store the server manages is missing its `.idmap.json` and holds vectors without an embedded id (written by 0.2.3 or earlier), queries return an error naming the missing file instead of empty or renumbered results. Opening such a store for writing is refused, because new vectors would reuse labels that already belong to stored ones; `readOnly: true` still works.\n\n### Use the same index from Claude Code\n\n`--data-dir` must be an absolute path: the MCP client starts the server from its own working directory.\n\n```bash\nclaude mcp add rvf -- npx -y @ruvector/rvf-mcp-server --data-dir \"$PWD/stores\"\nclaude mcp get rvf\n```\n\n`claude mcp get rvf` should report `Status: ✔ Connected`. Then ask Claude to open `docs.rvf` and search it. To share the server with a project, add `--scope project`, which writes this `.mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"rvf\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@ruvector/rvf-mcp-server\", \"--data-dir\", \"/absolute/path/to/stores\"],\n      \"env\": {}\n    }\n  }\n}\n```\n\n### How it works\n\n<p align=\"center\"><img src=\"https://raw.githubusercontent.com/ruvnet/RuVector/main/npm/packages/rvf-mcp-server/assets/rvf-mcp-flow.svg\" alt=\"An MCP client sends tools/call rvf_query over stdio; rvf-mcp-server resolves the store inside --data-dir, searches the .rvf file's HNSW index through @ruvector/rvf, and returns ids ranked by distance.\" width=\"100%\"></p>\n\n## Install\n\n```bash\nnpx @ruvector/rvf-mcp-server --transport stdio\n```\n\n## Claude Code Integration\n\nAdd to your MCP config:\n\n```json\n{\n  \"mcpServers\": {\n    \"rvf\": {\n      \"command\": \"npx\",\n      \"args\": [\"@ruvector/rvf-mcp-server\", \"--transport\", \"stdio\"]\n    }\n  }\n}\n```\n\n## Transports\n\n```bash\n# stdio (for Claude Code, Cursor, etc.)\nnpx @ruvector/rvf-mcp-server --transport stdio\n\n# SSE (for web clients)\nnpx @ruvector/rvf-mcp-server --transport sse --port 3100\n```\n\nThe SSE transport binds `127.0.0.1` by default and serves one session at a time. It has no authentication; use `--host <address>` to bind elsewhere only behind your own auth proxy. Point clients at `http://127.0.0.1:3100/sse` (on dual-stack hosts `localhost` may resolve to `::1`; use `--host ::1` if your client needs it).\n\n## Storage\n\nStores are real `.rvf` files written through [`@ruvector/rvf`](https://www.npmjs.com/package/@ruvector/rvf), so they survive server restarts and queries go through the native HNSW index instead of a linear scan. Every tool `path` is resolved inside the data directory: `--data-dir <dir>`, else `$RVF_MCP_DATA_DIR`, else `~/.rvf-mcp-server`. Absolute paths, `..` segments and symlinks that lead outside it are rejected. Per-vector metadata lives next to each store in `<store>.mcp-meta.jsonl`; only the vector id is also written into the `.rvf` itself. Metadata filters are applied to an over-fetched index result.\n\n## MCP Tools\n\n| Tool | Description |\n|------|-------------|\n| `rvf_create_store` | Create a new RVF vector store |\n| `rvf_open_store` | Open an existing store |\n| `rvf_close_store` | Close and release writer lock |\n| `rvf_ingest` | Insert vectors with optional metadata |\n| `rvf_query` | k-NN similarity search with filters |\n| `rvf_delete` | Delete vectors by ID |\n| `rvf_delete_filter` | Delete vectors matching a filter |\n| `rvf_compact` | Compact store to reclaim space |\n| `rvf_status` | Get store status |\n| `rvf_list_stores` | List all open stores |\n\n## MCP Resources\n\n| URI | Description |\n|-----|-------------|\n| `rvf://stores` | JSON listing of all open stores |\n\n## MCP Prompts\n\n| Prompt | Description |\n|--------|-------------|\n| `rvf-search` | Natural language similarity search |\n| `rvf-ingest` | Data ingestion with auto-embedding |\n\n## Requirements\n\n- Node.js >= 18.0.0\n\n## Works with / Used by\n\n- **Depends on** [`@ruvector/rvf`](https://www.npmjs.com/package/@ruvector/rvf) for the `.rvf` file format and HNSW search (native binding [`@ruvector/rvf-node`](https://www.npmjs.com/package/@ruvector/rvf-node)), plus [`@modelcontextprotocol/sdk`](https://www.npmjs.com/package/@modelcontextprotocol/sdk), `express` (SSE transport) and `zod` (tool input schemas).\n- **Works with** any MCP client that can launch a stdio server or connect to an SSE endpoint, including Claude Code and Cursor.\n- **Used by**: no published npm package depends on `@ruvector/rvf-mcp-server` today.\n- **Related**: the [`ruvector`](https://www.npmjs.com/package/ruvector) CLI's own MCP server (`ruvector mcp start`) also exposes path-based `rvf_*` tools alongside its other tools. Use this package when you want only the RVF tools, a data directory that tool paths cannot escape, and four runtime dependencies.\n\n## License\n\nMIT\n\n---\n\nPart of [RuVector](https://github.com/ruvnet/RuVector) · [ruv.io](https://ruv.io)\n","readmeFilename":"README.md"}