synxis-pms-mcp

MCP搜索检索

提供方 lesleslie

搜索检索 stdio · 本地进程 OAuth 授权 社区 / 第三方 ClaudeCodex
查看接入方式

SynXis PMS MCP Server is an MCP service that exposes property management workflows via FastMCP, offering guest lookup, room status, check-in/check-out, and folio retrieval for agent-driven hotel front desk and property operations.

一句话选型结论

按资料字段整理

synxis-pms-mcp 属于搜索检索类 MCP 服务器,stdio · 本地进程,OAuth 授权,可直接接入 Claude、Codex,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类搜索检索 传输方式stdio · 本地进程 鉴权OAuth 授权 部署方式本地部署
GitHub 星标 2 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

搜索检索
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

Local Deployment MCP server property management system Python hotel operations guest lookup room status check-in/check-out folio retrieval FastMCP

支持客户端

适用场景

Local DeploymentMCP serverproperty management system

安装与配置

stdio · 本地进程 OAuth 授权
客户端在本机拉起子进程,数据不出本机
uv run synxis-pms-mcp start

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 python,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
联网搜索取证

让模型查最新资料并给出出处。

资料聚合

把一个主题的网页、文档集中抓回来整理。

情报与竞品检索

按关键词持续检索行业动态和竞品信息。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude、Codex,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在搜索检索场景里让模型直接调用外部能力的人。
  • 已经在用 Claude、Codex 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
synxis-pms-mcp当前 未标注 stdio · 本地进程 本地部署 有 2026-09-27
Brave Search 433812ff 2 未标注 未标注 无 2026-05-17
Sequentialthinking 1 SSE · 服务端推送 远程部署 有 2026-05-18
Baidu Netdisk 未标注 未标注 未标注 无 2026-05-17
ragflow 未标注 stdio · 本地进程 本地部署 有 2026-04-11
mindsdb (430e18) 未标注 未标注 未标注 有 2026-05-17

服务器档案

搜索检索
字段来自项目仓库与公开索引,中文说明由本站标注
提供方lesleslie上游标注的维护方 lesleslie
分类搜索检索本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · python本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-09-27上游最后核验时间

详细介绍

7.0 KB
来自项目仓库与上游目录的原文,未做删改

SynXis PMS MCP Server

Unofficial MCP server for SynXis PMS (Property Management System) API.

Version: 0.2.1
Status: Standalone FastMCP server

Quick Links

  • Overview
  • Capabilities
  • Quick Start
  • MCP Server Configuration
  • Tool Reference
  • Configuration
  • Development

Quality & CI

Crackerjack is the standard quality-control and CI/CD gate for SynXis PMS MCP changes.


Overview

SynXis PMS MCP exposes property-management workflows through a FastMCP server. It is designed for agent-facing hotel operations such as guest lookup, room status checks, check-in, check-out, and folio review while keeping provider credentials, request validation, and transport concerns in a narrow integration boundary.

The server is intentionally separate from synxis-crs-mcp. PMS owns on-property operational workflows; CRS owns central reservation shopping, rates, availability, and booking workflows.

Capabilities

Implemented tool surface:

  • Guest lookup: retrieve guest profile details by guest ID
  • Room status: inspect room status, type, features, floor, and occupancy
  • Check-in: assign a room and complete guest arrival workflow
  • Check-out: complete departure workflow and return billing summary details
  • Folio lookup: retrieve charges, payments, totals, and balance information
  • Mock mode: exercise the MCP tool surface without live SynXis credentials
  • HTTP health routes: /health and /healthz for MCP client and process supervision checks

Quick Start

Prerequisites

  • Python 3.13+
  • UV package manager
  • SynXis PMS OAuth2 credentials for live API access

Local Setup```bash

git clone https://github.com/lesleslie/synxis-pms-mcp.git
cd synxis-pms-mcp
uv sync --group dev


### Run In Mock Mode

Mock mode is the safest way to validate client wiring and tool behavior before using live credentials.```bash
export SYNXIS_PMS_MOCK_MODE=true
uv run synxis-pms-mcp start
uv run synxis-pms-mcp health

Run With Live Credentials```bash

export SYNXIS_PMS_CLIENT_ID="your-client-id"
export SYNXIS_PMS_CLIENT_SECRET="your-client-secret"
export SYNXIS_PMS_PROPERTY_ID="your-property-id"
uv run synxis-pms-mcp start


The default HTTP bind is `127.0.0.1:3047`.

## CLI Commands

The CLI is built with `mcp-common` and provides the standard lifecycle command surface used by FastMCP servers.```bash
uv run synxis-pms-mcp start      # Start the HTTP MCP server
uv run synxis-pms-mcp stop       # Stop the managed server process
uv run synxis-pms-mcp restart    # Restart the managed server process
uv run synxis-pms-mcp status     # Show process status
uv run synxis-pms-mcp health     # Run the local health probe

MCP Server Configuration

Claude / Codex Style Configuration

Add the server to an MCP client configuration:```json
{
"mcpServers": {
"synxis-pms": {
"command": "uv",
"args": ["run", "synxis-pms-mcp", "start"],
"cwd": "/Users/les/Projects/synxis-pms-mcp",
"env": {
"SYNXIS_PMS_MOCK_MODE": "true"
}
}
}
}


For live access, replace mock mode with credential environment variables supplied by your secret manager.

### Health Checks```bash
curl http://127.0.0.1:3047/health
curl http://127.0.0.1:3047/healthz

Installation via Claude Code marketplace

This repo ships a Claude Code plugin manifest (.claude-plugin/plugin.json) plus a colocated .mcp.json and three slash commands in commands/. To install, register the www-mcp-servers marketplace with Claude Code, then install the plugin by name (synxis-pms). The plugin registers the MCP server over HTTP at http://localhost:3047/mcp, so start the server (uv run synxis-pms-mcp start) before invoking any command. Once installed, the slash commands /synxis-pms-property, /synxis-pms-room, and /synxis-pms-stay become available alongside the mcp__synxis-pms__* tools.

Tool Reference

Tool Purpose Required Inputs
get_guest Retrieve guest profile details guest_id
get_room_status Retrieve room status and room metadata room_id
check_in Check in a reservation to a room reservation_id, room_id
check_out Check out a reservation and return billing summary reservation_id
get_folio Retrieve folio charges, payments, totals, and balance reservation_id

Tool responses follow a consistent ToolResponse shape:```json
{
"success": true,
"message": "Room 1201 status: clean",
"data": {},
"error": null,
"next_steps": []
}


## Configuration

Committed defaults live in `settings/synxis-pms.yaml`. Runtime overrides should come from environment variables or a local `.env` file that is not committed.

| Setting | Environment Variable | Default |
|---------|----------------------|---------|
| Client ID | `SYNXIS_PMS_CLIENT_ID` | empty |
| Client secret | `SYNXIS_PMS_CLIENT_SECRET` | empty |
| Base URL | `SYNXIS_PMS_BASE_URL` | `https://api.synxis.com/pms/v1` |
| Property ID | `SYNXIS_PMS_PROPERTY_ID` | empty |
| Mock mode | `SYNXIS_PMS_MOCK_MODE` | `false` |
| Timeout | `SYNXIS_PMS_TIMEOUT` | `30.0` |
| Max retries | `SYNXIS_PMS_MAX_RETRIES` | `3` |
| HTTP host | `SYNXIS_PMS_HTTP_HOST` | `127.0.0.1` |
| HTTP port | `SYNXIS_PMS_HTTP_PORT` | `3047` |
| Log level | `SYNXIS_PMS_LOG_LEVEL` | `INFO` |
| JSON logs | `SYNXIS_PMS_LOG_JSON` | `true` |

## Project Structure```text
synxis_pms_mcp/
  __init__.py         # Package marker + version
  __main__.py         # python -m synxis_pms_mcp entry point
  cli.py              # mcp-common lifecycle CLI
  client.py           # SynXis PMS client boundary
  config.py           # Pydantic settings and logging
  models.py           # Typed PMS domain models
  server.py           # FastMCP application factory
  tools/
    __init__.py        # Package marker
    pms_tools.py       # Registered MCP tools
    profiles.py        # Tool profile gating
settings/
  synxis-pms.yaml     # Committed defaults
tests/
  __init__.py          # Package marker
  test_example.py      # Smoke fixtures
  test_version_sync.py # User-Agent / version stamp guard
  test_doc_drift.py    # Doc-drift CI guard
  __init__.py
  test_example.py
  unit/
    test_fastmcp_version.py
    test_no_direct_fastmcp_imports.py

Development```bash

uv sync --group dev
uv run pytest
uv run ruff check synxis_pms_mcp tests
uv run ruff format synxis_pms_mcp tests


Use direct `pytest` commands for targeted debugging:```bash
uv run pytest tests/test_example.py -v

Security Notes

  • Do not commit SynXis credentials, bearer tokens, tenant identifiers, guest profile data, or folio/payment details.
  • Keep examples and tests on mock mode or scrubbed fixtures.
  • Treat check-in, check-out, room assignment, and billing payloads as sensitive operational data.
  • Keep SynXis URLs, ports, and property settings configurable rather than hard-coded in new code.

Built on Oneiric for runtime configuration
and mcp-common for the FastMCP
baseline. Crackerjack gates every commit.

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
synxis-pms-mcp 怎么安装?

在客户端按下面的安装命令接入:uv run synxis-pms-mcp start。装完在客户端配置里引用同一个包或端点。

synxis-pms-mcp 怎么在 Claude、Codex 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

synxis-pms-mcp 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

synxis-pms-mcp 需要 API Key 吗?

资料标注需要OAuth 授权认证,使用前准备好对应凭据,并按最小权限配置。

synxis-pms-mcp 支持哪些客户端?

资料标注支持 Claude、Codex;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

synxis-pms-mcp 能提供哪些能力?

资料显示能力标签包括 Local Deployment、MCP server、property management system、Python、hotel operations、guest lookup。具体工具清单以官方文档为准。

synxis-pms-mcp 需要什么运行环境?

运行时为 python;属于本地进程,需要在本机装好运行环境。

synxis-pms-mcp 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-09-27。