{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_9asupt5sykqx","handle":"my-mongodb-mcp","url":"https://wellknown.network/agents/my-mongodb-mcp","links":{"self":"https://wellknown.network/agents/my-mongodb-mcp/record.json","html":"https://wellknown.network/agents/my-mongodb-mcp","markdown":"https://wellknown.network/agents/my-mongodb-mcp/record.md","api":"https://wellknown.network/api/v1/agents/my-mongodb-mcp","status":"https://wellknown.network/api/v1/agents/my-mongodb-mcp/status","claim":"https://wellknown.network/agents/my-mongodb-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/my-mongodb-mcp/claim.json","badge":"https://wellknown.network/agents/my-mongodb-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:my-mongodb-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"my-mongodb-mcp","summary":"MongoDB MCP Server - Query and manage MongoDB databases through MCP protocol","description":"# MongoDB MCP Server - Streamable HTTP\n\n基于 MCP 官方 SDK 实现的 MongoDB MCP Server，采用 **Streamable HTTP** 传输协议，完美支持 FastGPT。\n\n## 项目结构\n\n```\npython-mcp-server/\n├── src/my_mongodb_mcp/\n│   ├── __init__.py\n│   └── server.py          # 核心代码（11 个工具函数）\n├── tests/\n│   └── test_server.py\n├── pyproject.toml         # 打包配置\n├── .env.example           # 环境变量模板\n├── .env                   # 实际环境变量（需自行配置）\n├── .gitignore\n└── README.md\n```\n\n## 可用工具\n\n| 工具名 | 描述 | 写操作 |\n|--------|------|--------|\n| list_databases | 列出所有数据库 | ❌ |\n| list_collections | 列出数据库中的集合 | ❌ |\n| find_documents | 查询文档 | ❌ |\n| count_documents | 统计文档数量 | ❌ |\n| aggregate | 聚合管道操作 | ❌ |\n| list_indexes | 列出索引 | ❌ |\n| get_collection_stats | 获取集合统计 | ❌ |\n| insert_document | 插入单个文档 | ✅ |\n| update_documents | 更新文档 | ✅ |\n| delete_documents | 删除文档 | ✅ |\n| create_index | 创建索引 | ✅ |\n\n---\n\n## 🚀 完整操作流程（SOP）\n\n### 第一步：环境准备\n\n```powershell\n# 1. 创建 conda 环境（需要管理员权限）\nconda create -n mongodb-mcp python=3.12 -y\n\n# 2. 激活环境\nconda activate mongodb-mcp\n\n# 3. 进入项目目录\ncd C:\\Develop\\AI\\nju-skills-0210\\nju-skills\\app\\python-mcp-server\n```\n\n### 第二步：安装依赖\n\n```powershell\n# 安装项目依赖\npip install -e \".[dev]\"\n```\n\n### 第三步：配置环境变量\n\n```powershell\n# 复制环境变量模板\ncopy .env.example .env\n```\n\n编辑 `.env` 文件，填入实际配置：\n\n```ini\n# MongoDB 连接字符串\nMDB_MCP_CONNECTION_STRING=mongodb://username:password@host:27017/database?authSource=admin&directConnection=true\n\n# 只读模式（推荐开启，防止 AI 误操作）\nMDB_MCP_READ_ONLY=true\n\n# 数据库名（可选，默认使用连接串中的数据库）\nMDB_MCP_DATABASE=\n```\n\n### 第四步：启动服务器\n\n```powershell\n# 启动 Streamable HTTP 模式的 MCP Server\npython -m my_mongodb_mcp.server\n```\n\n**预期输出：**\n```\n🚀 MongoDB MCP Server 已启动（Streamable HTTP 模式）\n📍 地址：http://localhost:8000/\n📍 只读模式：是\n📍 数据库：fastgpt\nINFO:     Uvicorn running on http://0.0.0.0:8000\n```\n\n### 第五步：本地测试\n\n**浏览器访问：**\n```\nhttp://localhost:8000/\n```\n\n**或使用 curl 测试：**\n```powershell\ncurl http://localhost:8000/\n```\n\n### 第六步：内网穿透（可选，用于 FastGPT 云端访问）\n\n#### 6.1 启动 Cloudflare Tunnel\n\n**新开一个终端窗口：**\n\n```powershell\ncloudflared tunnel --url http://localhost:8000\n```\n\n**预…","publisher":null,"homepage":"https://github.com/yourusername/my-mongodb-mcp","repository":"https://github.com/yourusername/my-mongodb-mcp","version":"0.1.0","license":"MIT","protocols":["mcp"],"tags":["ai","database","mcp","model-context-protocol","mongodb"],"pricing":null,"endpoints":[{"url":"pypi:my-mongodb-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"data.database","name":"Databases","confidence":1,"provenance":"declared"}],"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":"my-mongodb-mcp","registry":"pypi","observedAt":"2026-09-10T07:21:43.940Z","publishedAt":"2026-04-07T06:29:30.681393Z","latestVersion":"0.1.0"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"my-mongodb-mcp","url":"https://pypi.org/project/my-mongodb-mcp/","firstSeenAt":"2026-09-10T07:20:50.535Z","fetchedAt":"2026-09-10T07:20:50.535Z","normalizedAt":"2026-09-10T07:20:50.535Z"}]},"firstSeenAt":"2026-09-10T07:20:50.535Z","updatedAt":"2026-09-10T07:21:43.940Z"}