Galipo MCP 服务器

关键词

Model Context ProtocolClaude AIFastMCPPostgreSQL后端服务

使用说明

项目简介

  • Galipo MCP 服务器是一个面向大型语言模型客户端的后端服务，实现了 MCP（Model Context Protocol）标准的资源、工具和提示模板管理能力，并通过 JSON-RPC 与客户端进行通信，提供安全、可扩展的上下文服务。

主要功能点

  • MCP 服务端核心能力
    • 提供资源(Data/Resources)的托管与访问能力
    • 注册并执行 Tools(工具)，允许 LLM 调用外部功能
    • 定义与渲染 Prompt 模板（Prompts），支持自定义的对话交互模式
    • 会话管理与能力声明，支持多种传输协议
  • 传输与认证
    • 支持 SSE（Server-Sent Events）与 stdio 等传输，以及可切换的传输中继
    • 可选的 Bearer token 认证，支持数据库用户以及环境变量回退认证
  • 数据与能力
    • 通过 FastAPI + FastMCP 与 PostgreSQL 数据库进行资源与能力的持久化管理
    • 41+ MCP 工具覆盖病例、人员、任务、事件、进程等领域，便于 Claude/Ai 集成进行自然语言查询与执行
  • 开发与扩展性
    • 提供前后端分离的工具注册、路由及授权插件
    • 支持自定义登录页、动态客户端注册、授权码方式等 OAuth 拓展

安装与运行

  • 依赖与运行环境
    • Python 3.12 及以上
    • PostgreSQL 数据库（本地或云端可用）
    • 需要的 Python 包在项目的依赖文件中列出，可通过 pip 安装
  • 运行方式
    • Stdout/HTTP 服务模式：直接运行主 MCP 服务脚本，默认以 SSE 传输在 8000 端口对外提供 API，支持通过环境变量进行配置
    • Claude Desktop 模式：也可通过快速的 stdio 模式与 Claude Desktop/Claude.ai 配合使用

服务器配置与对接

  • MCP 客户端对接配置（简要说明）
    • MCP 客户端需要配置一个服务器条目，包含服务名称、启动命令和参数，以便在会话中连接和使用。下面给出一个示意性的 JSON 配置字段说明，用于帮助配置管理，但实际客户端无需在此处执行代码。
    • server_name: 服务在你的对话环境中的名称，例如 "Galipo MCP Server"
    • command: 服务器启动命令（不需要在此直接执行，而是作为客户端连接信息的来源）
    • args: 启动参数，用于启动服务器并指定传输模式与端口
    • 备注：Galipo 的 MCP 服务默认提供 SSE 传输（端口 8000）以及可选的 stdio 模式，认证可按需开启
  • 注释性配置示意
    • 服务器名称：Galipo MCP Server
    • 启动命令和参数（示例，具体以实际部署为准）：
      • 启动命令（示例）：uvicorn
      • 启动参数（示例）：["main:app", "--reload", "--port", "8000"]
    • 说明：上面信息用于客户端在启动阶段建立连接；在本仓库中，MCP 服务也提供了直接运行脚本的方式，便于开发与本地调试。
  • 启动方式与传输对接
    • 直接启动（推荐开发/测试环境）：
      • 运行主 MCP 服务脚本（main.py），默认以流式传输（streamable-http/或 SSE）在端口 8000 提供服务
    • 仅 Claude Desktop 使用的本地调试模式（stdio）：
      • 启动 mcp_stdio.py，以 stdio 方式与 Claude Desktop 进行通信
  • 认证与安全
    • 服务端可启用基于 JWT 的 Bearer Token 认证，默认支持数据库用户认证，环境变量回退也可用作迁移期的临时方案
    • 在没有配置认证的情况下，仍可作为无认证环境运行（开发阶段可用）
  • 部署建议
    • 传输协议：SSE（端口 8000）或 stdio（开发时适用）
    • 数据库：PostgreSQL，需初始化并提供必要的 schema（本仓库包含完整的数据库操作实现）
    • 生产环境建议通过反向代理进行 TLS/HTTPS 封装与 SSE 转发优化

基本使用方法

  • 快速上手
    • 克隆代码库
    • 安装依赖（Python 端）
    • 配置数据库及环境变量（如 AUTH、JWT、数据库连接等，按仓库中的 README/SETUP 指南配置）
    • 启动 MCP 服务器（Web/SSE 模式）：
      • 运行主脚本，监听端口（默认 8000），即可通过 Claude/LLM 客户端接入
    • 通过 Claude/Claude Code 等工具，将 MCP 服务器作为后端工具集合接入，直接对接 41+ 工具集成能力
  • 常见操作
    • 使用工具调用、读取资源、获取 Prompts、以及与 LLM 的对话交互
    • 在客户端的会话中按需创建会话、注册工具、注册资源等，以实现对外部功能的扩展

备注

  • 项目内置了 41+ MCP 工具、OAuth 登录页面、Seed 数据脚本以及多种辅助工具，目标是成为一个完整的 MCP 服务器实现，支撑 react/前端仪表盘的管理与 Claude/Ai 的集成。

关键词 Model Context Protocol, Claude AI, FastMCP, PostgreSQL, 后端服务

分类ID 6

服务器信息

访问项目