magisterium MCP server

Magisterium MCP服务器

一 主控程序 为AI助手提供访问权限的服务器 API司法官 引用权威的天主教会教义。

显示一个工具-- magisterium_query --任何兼容MCP的客户端（Claude Desktop、Claude Code、Cursor等）都可以调用。

远程MCP端点

服务器托管在 https://magisterium.stephens.page/mcp --无需本地安装。

克劳德代码

添加 ~/.claude/settings.json:

{
  "mcpServers": {
    "magisterium": {
      "type": "url",
      "url": "https://magisterium.stephens.page/mcp"
    }
  }
}

开爪

添加 ~/.openclaw/openclaw.jsonOpenClaw的基于URL的传输已在模式中，但在运行时尚未完全支持(#55087)，所以现在使用本地安装的stdio传输：

{
  mcp: {
    servers: {
      "magisterium": {
        command: "/bin/bash",
        args: ["/path/to/magisterium_mcp_server/run-magisterium.sh"],
      },
    },
  },
}

一旦OpenClaw提供了原生HTTP MCP支持，您就可以切换到远程端点：

{
  mcp: {
    servers: {
      "magisterium": {
        url: "https://magisterium.stephens.page/mcp",
      },
    },
  },
}

看 本地设置 以下部分为安装说明。

克劳德桌面/光标/其他MCP客户端

使用流式HTTP URL https://magisterium.stephens.page/mcp 在客户的MCP配置中。有关确切格式，请参阅客户的文档。

本地设置（可选）

如果您更喜欢通过stdio在本地运行服务器：

先决条件

• Node.js 18+ （检查 node --version)
• API监管机构密钥 从 magisterium.com

安装

git clone https://github.com/JacobStephens2/magisterium_mcp_server.git
cd magisterium_mcp_server
npm install
npm run build

创建一个 .env 使用API密钥文件（请参阅 .env.example):

MAGISTERIUM_API_KEY=sk_your_key_here

验证它是否有效：

npm test

配置MCP客户端以供本地使用

添加到MCP配置(claude_desktop_config.json 对于桌面， ~/.claude/settings.json 克劳德代码）：

{
  "mcpServers": {
    "magisterium": {
      "command": "/bin/bash",
      "args": ["/path/to/magisterium_mcp_server/run-magisterium.sh"]
    }
  }
}

工具： magisterium_query

示例

{
  "name": "magisterium_query",
  "arguments": {
    "query": "What does the Catholic Church teach about the Eucharist?"
  }
}

回复包括格式化的教学文本、带有文件标题和作者的引文，以及可选的相关后续问题。

建筑

服务器作为一个Express进程运行，为三个端点提供服务：

• / --静态前端
• /api/query -用于前端的REST API
• /mcp --AI代理的可流式HTTP MCP端点

Apache反向代理 /api 和 /mcp 到Node.js后端；TLS通过Let's Encrypt在边缘终止。

发展

npm run build    # Compile TypeScript to dist/
npm run dev      # Watch mode — auto-rebuild on changes
npm start        # Run the stdio MCP server
npm run web      # Run the web server (REST API + MCP endpoint)
npm test         # Test server responds to MCP handshake

主要源文件是 web-server.ts （具有REST+MCP端点的Express服务器）和 mcp-magisterium.ts （stdio MCP服务器）。编辑后，运行 npm run build 重新编译。

故障排除

“找不到模块”错误 --快跑 npm install 然后 npm run build.

“未设置MAGISTERIUM_API_KEY环境变量” --确保 .env 与您的API密钥一起存在于项目根目录中。这 run-magisterium.sh 包装器脚本 cds到正确的目录，以便dotenv可以找到它。

服务器手动工作，但不在MCP客户端中工作 --使用 run-magisterium.sh 包装器脚本（不是 node 直接）。它确保工作目录是正确的，无论客户端如何生成进程。

游标中“启用了0个工具” --添加配置后完全退出并重新启动Cursor。检查配置中的路径是否正确 run-magisterium.sh 可执行(chmod +x run-magisterium.sh).