MongoDB MCP 服务器
强大的模型上下文协议 (MCP) 服务器实现，可通过标准化协议与 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 /health - MCP 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"
}
}
}
}
可用工具
| 工具名称 | 解释 |
|---|
listCollections | 列出数据库中所有可用的集合 |
find | 使用 MongoDB 查询语法检索集合中的文档 |
insertOne | 将单个文档插入集合 |
updateOne | 更新集合中的单个文档 |
deleteOne | 从集合中删除单个文档 |
indexes | 列出集合中的所有索引 |
createIndex | 在集合中创建新索引 |
dropIndex | 从集合中删除现有索引 |
高级用法
添加自定义工具
- 在
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文件。