给上帝的信MCP服务器
一个模型上下文协议(MCP)服务器,通过AI与OpenAI的ChatGPT集成提供个性化的圣经指导和辅导。
特性
- 个性化圣经指导:根据您的姓名和当前感受获得定制的精神指导
- 三段选段:AI为您的情况找到了三个相关的圣经经文
- 来自上帝的个性化信件:收到一封完整的信,好像是全能的上帝写的
- 圣经故事和寓言:包括每段经文的相关故事和解释
- 可采取行动的建议:提供实际活动和行动,以帮助应对和克服问题
- 多种访问方法:CLI界面和MCP服务器集成
- 美丽的终端输出:彩色、格式化的回复,便于阅读
快速开始
✅ 选项1:全局安装或通过NPX立即使用(无需安装)
npm install -g letter-to-god-mcp-server或
# Install dependencies
npm npx letter-to-god-mcp-server设置API密钥:
您必须提供您的OpenAI API密钥,工具才能工作。
•选项A:设置环境变量
export OPENAI_API_KEY="your-api-key-here"•选项B:在当前目录中创建.env文件
echo "OPENAI_API_KEY=your-api-key-here" > .env将此.env文件放在运行命令的同一目录中。
选项2:命令行界面(立即使用)
获得圣经指导的最快方法:
# Install dependencies
npm install
# Get guidance directly from command line
node cli.js --name "John" --feeling "anxious about my future"
node cli.js --name "Sarah" --feeling "struggling with forgiveness"
node cli.js -n "David" -f "feeling lost and confused"
# See all options
node cli.js --help选项3:MCP服务器(用于集成)
作为MCP服务器运行,以便与MCP客户端集成:
node index.js用法
服务器提供了一个主要工具:
getBibleGuidance
参数:
name(string,必填):您的姓名feeling(字符串,必填):你今天的感受或你面临的问题
示例用法: 当连接到MCP客户端时,您可以调用:
getBibleGuidance({
name: "John",
feeling: "anxious about my future and feeling lost"
})答复:
- 人工智能将作为全能的上帝,提供:
- 三个相关的圣经经文 - 一封附有解释的个性化信件 - 圣经故事和寓言 - 实际行动和活动 - 全部格式化为来自上帝的直接信息
输出
服务器提供两种类型的输出:
- 终端显示器:完整响应以清晰的格式记录到控制台
- MCP响应:向MCP客户端返回结构化响应
技术细节
- 模型:使用GPT-4进行高质量响应
- 最大令牌数:2000个代币用于全面指导
- 温度:0.7用于平衡创造力和一致性
- 系统提示:被配置为具有圣经专业知识的全能上帝
终端输出示例
=== Processing Bible guidance request ===
Name: John
Feeling: anxious about my future
Timestamp: 2025-01-20T14:45:00.000Z
==========================================
Sending request to OpenAI...
=== BIBLE GUIDANCE RESPONSE ===
My beloved child John,
I see your heart heavy with anxiety about your future...
[Full AI response with scriptures, stories, and guidance]
===============================MCP客户端集成指南
A.与Cline一起使用(VSCode扩展)
- 安装Cline扩展 在VSCode中
- 配置MCP服务器:
- 打开临床设置 - 添加MCP服务器配置:
{
"mcpServers": {
"bible-expert": {
"command": "node",
"args": ["/path/to/your/project/index.js"],
"cwd": "/path/to/your/project"
}
}
}- 用于临床:
- 与Cline开始对话 - 问:“使用名为‘约翰’的getBibleGuidance工具,并感到‘对我的未来感到焦虑’” - Cline将呼叫您的MCP服务器并显示圣经指南
B.使用Claude Desktop
- 查找配置文件:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - 视窗: %APPDATA%\Claude\claude_desktop_config.json
- 添加服务器配置:
{
"mcpServers": {
"bible-expert": {
"command": "node",
"args": ["/absolute/path/to/your/project/index.js"],
"cwd": "/absolute/path/to/your/project"
}
}
}- 重新启动克劳德桌面
- 在对话中使用:
Can you use the getBibleGuidance tool to help me?
My name is Sarah and I'm feeling overwhelmed with work stress.C.与其他MCP客户端一起使用
通用配置:
- 服务器命令:
node index.js - 工作目录:您的项目目录
- 运输标准: stdio
- 工具名称:
getBibleGuidance - 所需参数:
name(字符串),feeling(字符串)
D.手动MCP测试
使用MCP检查员进行测试 (如有):
# Install MCP inspector
npm install -g @modelcontextprotocol/inspector
# Run inspector
mcp-inspector node index.js直接stdio通信:
# Start server
node index.js
# Send JSON-RPC messages (example)
{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}
{"jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": {"name": "getBibleGuidance", "arguments": {"name": "John", "feeling": "anxious"}}}故障排除
常见问题
- “未配置API密钥”:
- 检查你的 .env 文件具有正确的OpenAI API密钥 - 确保钥匙以开头 sk-
- “服务器未连接”:
- 验证路径 index.js MCP客户端配置正确 - 检查Node.js是否已安装且可访问 - 确保安装了所有依赖项(npm install)
- “找不到工具”:
- 配置更改后重新启动MCP客户端 - 验证服务器是否正在运行且没有错误 - 检查工具名称是否准确 getBibleGuidance
- “OpenAI没有回应”:
- 检查您的互联网连接 - 验证您的OpenAI API密钥是否有足够的信用 - 检查OpenAI服务状态
调试模式
使用调试输出运行服务器:
DEBUG=* node index.js测试连接
使用测试脚本验证一切正常:
node test-server.js错误处理
该服务器包括全面的错误处理功能,用于:
- OpenAI API失败
- 缺少API密钥
- 网络问题
- 无效响应
- MCP协议错误
所有错误都会记录到控制台,并作为结构化响应返回给MCP客户端。
软件包脚本
将这些添加到您的 package.json 为方便起见:
{
"scripts": {
"start": "node index.js",
"cli": "node cli.js",
"test": "node test-server.js",
"build": "npx tsc"
}
}然后使用:
npm start # Start MCP server
npm run cli -- --name "John" --feeling "anxious" # CLI usage
npm test # Test server
npm run build # Compile TypeScript