{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_u355cevnr6tz","handle":"pgvector-mcp-server","url":"https://wellknown.network/agents/pgvector-mcp-server","links":{"self":"https://wellknown.network/agents/pgvector-mcp-server/record.json","html":"https://wellknown.network/agents/pgvector-mcp-server","markdown":"https://wellknown.network/agents/pgvector-mcp-server/record.md","api":"https://wellknown.network/api/v1/agents/pgvector-mcp-server","status":"https://wellknown.network/api/v1/agents/pgvector-mcp-server/status","claim":"https://wellknown.network/agents/pgvector-mcp-server/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/pgvector-mcp-server/claim.json","badge":"https://wellknown.network/agents/pgvector-mcp-server/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:pgvector-mcp-server","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"pgvector-mcp-server","summary":"Model Context Protocol server for PostgreSQL vector database management with pgvector extension","description":"# pgvector MCP Server\n\n一个基于 Model Context Protocol (MCP) 的 PostgreSQL 向量数据库管理服务器，专为现代AI应用设计。\n\n## 功能特性\n\n- **MCP 兼容**: 完全基于 Model Context Protocol，与AI助手无缝集成\n- **集合管理**: 创建、列出、重命名和删除向量集合\n- **向量操作**: 添加向量、搜索相似内容、批量文档处理\n- **智能编码**: 自动检测文件编码，特别优化Windows中文文件兼容性\n- **嵌入服务**: 集成阿里云DashScope text-embedding-v4模型\n- **现代包管理**: 基于uv包管理器，快速安装和依赖管理\n- **原子操作**: 数据库事务保证集合重命名等操作的原子性\n- **跨平台支持**: Windows、macOS、Linux全平台兼容\n\n## 快速开始\n\n### 1. 安装方式\n\n**方式1：使用 uvx 直接运行 (最推荐)**\n```bash\n# 无需安装，直接在MCP配置中使用uvx运行\n# uvx会自动下载和管理包\n```\n\n**方式2：使用 uv 安装**\n```bash\n# 全局工具安装\nuv tool install pgvector-mcp-server\n\n# 或项目依赖安装\nuv add pgvector-mcp-server\n```\n\n**方式3：使用 pip 安装**\n```bash\npip install pgvector-mcp-server\n```\n\n### 2. 设置数据库\n\n```bash\n# 连接PostgreSQL并启用pgvector扩展\npsql postgres -c \"CREATE EXTENSION IF NOT EXISTS vector;\"\n\n# 创建专用数据库（可选）\ncreatedb mcp_vectors\n```\n\n### 3. 配置MCP客户端\n\n在你的MCP客户端配置文件中添加以下配置 (例如 Claude Desktop):\n\n**推荐配置 (使用 uvx，无需预安装)**:\n```json\n{\n  \"mcpServers\": {\n    \"pgvector-mcp-server\": {\n      \"command\": \"uvx\",\n      \"args\": [\"pgvector-mcp-server\"],\n      \"env\": {\n        \"DATABASE_URL\": \"postgresql://username:password@localhost:5432/mcp_vectors\",\n        \"DASHSCOPE_API_KEY\": \"your_dashscope_api_key_here\",\n        \"DEBUG\": \"false\"\n      }\n    }\n  }\n}\n```\n\n**备选配置 (如果已安装)**:\n```json\n{\n  \"mcpServers\": {\n    \"pgvector-mcp-server\": {\n      \"command\": \"pgvector-mcp-server\",\n      \"env\": {\n        \"DATABASE_URL\": \"postgresql://username:password@localhost:5432/mcp_vectors\",\n        \"DASHSCOPE_API_KEY\": \"your_dashscope_api_key_here\",\n        \"DEBUG\": \"false\"\n      }\n    }\n  }\n}\n```\n\n**传统配置 (使用 Python 模块)**:\n```json\n{\n  \"mcpServers\": {\n    \"pgvector-mcp-server\": {\n      \"command\": \"python\",\n      \"args\": [\"-m\", \"pgvector_mcp_server\"],\n      \"env\": {\n        \"DATABASE_URL\": \"postgresql://username:password@localhost:5432/mcp_vectors\",\n        \"DASHSCOPE_API_KEY\": \"your_dashscope_api_key_here\",\n        \"DEBUG\": \"false\"\n      }\n    }\n  }\n}\n```\n\n### 4. 验证安装\n\n使用MCP客户端调用 `status` 工具验证连接:\n\n```json\n{\n  \"tool\": \"st…","publisher":null,"homepage":null,"repository":null,"version":"1.0.6","license":"MIT","protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:pgvector-mcp-server","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"data.database","name":"Databases","confidence":1,"provenance":"derived"}],"categories":["data"],"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":"pgvector-mcp-server","registry":"pypi","observedAt":"2026-09-10T09:27:03.634Z","publishedAt":"2025-09-30T09:48:38.644157Z","latestVersion":"1.0.6"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"pgvector-mcp-server","url":"https://pypi.org/project/pgvector-mcp-server/","firstSeenAt":"2026-09-10T09:26:14.238Z","fetchedAt":"2026-09-10T09:26:14.238Z","normalizedAt":"2026-09-10T09:26:14.238Z"}]},"firstSeenAt":"2026-09-10T09:26:14.238Z","updatedAt":"2026-09-10T09:27:03.634Z"}