MongoDB MCP Server
MongoDB MCP 服务器
强大的模型上下文协议 (MCP) 服务器实现,可通过标准化协议与 MongoDB 数据库进行无缝交互。
作者
拉斯塔利昂
Related MCP server: MongoDB
大纲
该 MCP 服务器实现提供了一个强大的接口,可以通过模型上下文协议与 MongoDB 数据库进行交互。它通过异步/等待模式和错误处理为数据库、集合和文档的操作提供可靠的支持。
特征
全面支持 MongoDB CRUD 操作
处理与 MongoDB 的安全连接
异步/等待模式以实现最佳性能
全面的错误处理
Docker 支持,轻松部署
使用类型提示执行查询
支持服务器发送事件 (SSE) 以实现实时更新
快速入门
用作 CLI 工具
# 저장소 복제
git clone https://github.com/yourusername/mongo-mcp-server.git
cd mongo-mcp-server
# 개발 모드로 설치
pip install -e .
# 로컬에서 CLI 명령으로 실행
mongo-mcp-server
# SSE 트랜스포트로 실행
mongo-mcp-server --transport=sse
# MongoDB URL 지정
mongo-mcp-server --mongodb-url="mongodb://username:password@hostname:port/dbname"
# 도움말 보기
mongo-mcp-server --help通过 UVX 运行
# UVX가 설치된 경우
uvx mongo-mcp-server
# SSE 트랜스포트 모드
uvx mongo-mcp-server --transport=sse直接运行 Python
# 저장소 복제
git clone https://github.com/yourusername/mongo-mcp-server.git
cd mongo-mcp-server
# 의존성 설치
pip install -r requirements.txt
# 환경 변수 설정
export MONGODB_URL="mongodb://username:password@hostname:port/dbname?authSource=admin"
# 서버 실행
uvicorn app.main:app --host 0.0.0.0 --port 3000使用 Docker
# 저장소 복제
git clone https://github.com/yourusername/mongo-mcp-server.git
cd mongo-mcp-server
# Docker Compose로 빌드 및 실행
docker-compose up -d
# 로그 확인
docker-compose logs -f mongo-mcp使用 UVX
UVX 是一个可以让你轻松管理各种环境中的服务的工具。
# 등록 스크립트에 실행 권한 부여
chmod +x uvx-register.sh
# UVX에 서비스 등록
./uvx-register.sh
# 서비스 시작
uvx start mongo-mcp
# 상태 확인
uvx status mongo-mcp
# 로그 확인
uvx logs mongo-mcp有关详细信息,请参阅UVX 指南。
环境变量
运行服务器之前,请设置以下环境变量:
# 필수
MONGODB_URL="mongodb://username:password@hostname:port/dbname?authSource=admin"
# 선택 - 기본값 표시
PORT=3000
MCP_TRANSPORT=http # 'http' 또는 'sse'API 端点
检查健康状况:
GET /healthMCP API :
GET /mcp- FastMCP 端点(OpenAPI 文档)SSE 连接:
GET /sse- 服务器发送事件端点消息处理:
POST /messages- 消息处理端点
IDE 集成
VS Code 设置
将以下内容添加到您的 VS Code settings.json:
{
"mcp": {
"inputs": [
{
"type": "promptString",
"id": "mongodbUri",
"description": "MongoDB 연결 URI"
}
],
"servers": {
"mongodb": {
"command": "mongo-mcp-server",
"args": [
"--mongodb-url",
"$(mongodbUri)"
],
"env": {}
}
}
}
}克劳德或其他人工智能助手
为 Claude 或其他 AI 助手配置您的 MCP 服务器,如下所示:
{
"mcp": {
"servers": {
"mongodb": {
"url": "http://localhost:3000/mcp"
}
}
}
}可用工具
工具名称 | 解释 |
| 列出数据库中所有可用的集合 |
| 使用 MongoDB 查询语法检索集合中的文档 |
| 将单个文档插入集合 |
| 更新集合中的单个文档 |
| 从集合中删除单个文档 |
| 列出集合中的所有索引 |
| 在集合中创建新索引 |
| 从集合中删除现有索引 |
高级用法
添加自定义工具
在
app/tools/documents/或app/tools/collection/中创建一个新工具:
from ..base.tool import BaseTool
class MyNewTool(BaseTool):
@property
def name(self) -> str:
return "my_new_tool"
@property
def description(self) -> str:
return "새 도구에 대한 설명"
@property
def input_schema(self) -> Dict[str, Any]:
return {
"type": "object",
"properties": {
# 도구 입력 스키마 정의
}
}
async def execute(self, params: Dict[str, Any]) -> Dict[str, Any]:
# 도구 실행 로직 구현
pass在
app/tools/registry.py中注册该工具:
from .documents.my_new_tool import MyNewTool
# ToolRegistry.__init__ 메서드 내에서
self.register_tool(MyNewTool())安装和部署 CLI 工具
您可以通过在 PyPI 上将其注册为包来使其在全球范围内可用:
# setup.py 확인 후 빌드
python setup.py sdist bdist_wheel
# 패키지 업로드 (PyPI 계정 필요)
twine upload dist/*
# 전역 설치
pip install mongodb-mcp-bridge
# 어디서든 실행 가능
mongodb-mcp-bridge故障排除
如果服务器没有启动:使用
mongo-mcp-server --help查看帮助MongoDB 连接问题:验证
--mongodb-url参数是否正确工具执行错误:检查工具实现和输入参数
Docker 问题:使用
docker-compose logs mongo-mcp检查日志
Docker 配置
Docker配置包括:
Python 3.12 基础镜像
亚洲/首尔时区
MongoDB 4.4 实例
用于数据库存储的持久卷
对两种服务进行健康检查
自动化网络配置
执照
该项目根据 MIT 许可证分发 - 有关详细信息,请参阅LICENSE文件。
This server cannot be deployed
Maintenance
Related MCP Connectors
A Model Context Protocol (MCP) server for Selise Blocks Cloud integration
Model Context Protocol server for the Apideck Unified API. Connect any MCP-compatible agent framework to 100+ accounting systems, HRIS platforms, file storage providers, and more through one integration. More information https://www.apideck.com/mcp-server
Hosted MCP server for AI-driven data ops. Create apps, manage schemas, and CRUD structured data.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Related MCP Servers
- AlicenseNot gradedqualityFmaintenanceA Model Context Protocol (MCP) server that enables LLMs to interact directly with MongoDB databases. Query collections, inspect schemas, and manage data seamlessly through natural language.19 npm175MIT
- AlicenseBqualityAmaintenanceA Model Context Protocol server that provides access to MongoDB databases. This server enables LLMs to inspect collection schemas and execute read-only queries.8189 npm283MIT
- AlicenseNot gradedqualityFmaintenanceA modular server that enables management of MongoDB databases, collections, documents, indexes, and bulk operations through the Model Context Protocol (MCP) interface.MIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol (MCP) server for MongoDB operations, enabling AI assistants to interact with MongoDB databases through a standardized interface.28 npm4MIT