铸造MCP继电器
这是一个Node.js/TypeScript应用程序,在LLM MCP服务器(本项目)Foundry VTT之间转播事件和消息。
快速入门
npm install # 의존성 설치
cp .env.example .env # 환경 변수 템플릿 복사
npm run dev # 개발 모드 실행要求
- Node.js 20+
- npm 10+
环境变量
.env.example复制 .env创建并填充值。
PORT=3000 # 서버 바인드 포트
FOUNDRY_URL=http://localhost:30000
MCP_SERVER_URL=http://localhost:4000如果需要其他项目 .env.example和请一起更新本节。
脚本
| 命令 | 说明 |
|---|---|
npm run dev | 注册MCP加载程序后运行开发模式(loader-register.mjs 使用)。 |
npm run build | TypeScript dist/转换为。 |
npm start | 构建交付项 dist/server.js 运行(生产)。 |
部署(容器)
映像池和运行示例:
podman pull ghcr.io/darkbard81/fvtt-mcp:latest
podman run -d --name fvtt-mcp \
--env-file .env \
-p 3000:3000 \
ghcr.io/darkbard81/fvtt-mcp:latestpodman-compose如果使用 env_file: [.env]可以以相同的方式注入。
开发流程
.env准备→npm run dev用确认联动。- 更改后
npm run build验证类型/版本。 - 通过标记推送,GitHub Actions生成发行版/容器映像。
结构
├── src/ # TypeScript 소스
├── dist/ # 빌드 산출물
├── loader-register.mjs
└── AGENTS.md # 에이전트 설정 문서注意:认证选项
- Keycloak:功能丰富,有点重(Java)
- Ory Hydra:符合标准,相对轻
- Authelia:设置简单
- OAuth2 Proxy:在现有应用程序的前端添加认证层
