AI导哈

事件中继应用

Foundry MCP Relay是一个Node.js/TypeScript应用程序，用于在LLM、MCP服务器和Foundry VTT之间中继事件和消息。

  • by darkbard81
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 darkbard81/fvtt-mcp

使用说明

铸造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:latest

podman-compose如果使用 env_file: [.env]可以以相同的方式注入。

开发流程

  1. .env 准备→ npm run dev用确认联动。
  2. 更改后 npm run build验证类型/版本。
  3. 通过标记推送，GitHub Actions生成发行版/容器映像。

结构

├── src/               # TypeScript 소스
├── dist/              # 빌드 산출물
├── loader-register.mjs
└── AGENTS.md          # 에이전트 설정 문서

注意：认证选项

  • Keycloak：功能丰富，有点重（Java）
  • Ory Hydra：符合标准，相对轻
  • Authelia：设置简单
  • OAuth2 Proxy：在现有应用程序的前端添加认证层

相关 MCP