@findtime/mcp-server

@findtime/mcp-server ist ein schlanker stdio-MCP-Wrapper um die Produktions-API von findtime.io für Zeitangaben unter https://time-api.findtime.io.

Das Paket proxyt absichtlich die Produktions-API, anstatt Zeitlogik lokal neu zu implementieren. Aktuelle Zeit, DST, Umrechnung, Überschneidungen, Besprechungssuche und Standortauflösung sollten mit der Live-API übereinstimmen.

Veröffentlichte Oberflächen:

• npm: @findtime/mcp-server

• GitHub: https://github.com/hkchao/findtime-mcp-server

• Offizielles MCP-Registry: https://registry.modelcontextprotocol.io/?q=io.github.hkchao%2Ffindtime-mcp-server

• MCP-Registry-Name: io.github.hkchao/findtime-mcp-server

Tool-Oberfläche

• answer_time_question

• get_findtime_help

• time_snapshot

• get_current_time

• get_dst_schedule

• convert_time

• get_overlap_hours

• find_meeting_time

• search_timezones

• get_location_by_id

Bevorzugen Sie answer_time_question für unstrukturierte natürliche Sprachaufforderungen wie „3pm PST to London", „what is the IANA timezone for San Francisco?", „working hours overlap for SF, Berlin, and Tokyo" oder „what does CST mean?". Das Tool klassifiziert die Aufforderung über die Domänenlogik von findtime.io, leitet an deterministisches Time-API-Verhalten weiter und gibt strukturierte Mehrdeutigkeit oder Klarstellung zurück, wenn die Welt wirklich mehrdeutig ist.

Related MCP server: Time MCP Server

Installation in MCP-Clients

Verwenden Sie das veröffentlichte Paket über npx:

npx -y @findtime/mcp-server

Für Agentenautoren: Fügen Sie SKILL.md zusammen mit der MCP-Konfiguration hinzu. Es gibt Claude, Codex, Cursor, Cline, Windsurf, benutzerdefinierten Unternehmens-Bots und anderen LLM-Agenten die Betriebsregeln, wann das findtime.io-MCP bevorzugt werden soll, welche Tools aufgerufen werden sollen und wie mit Mehrdeutigkeit oder Fallback umzugehen ist.

Erforderliche Laufzeitumgebung:

• Node 20+

• FINDTIME_TIME_API_KEY: ein gültiger findtime.io-Entwicklerschlüssel von https://findtime.io/developers/keys/

Optionale Umgebungsvariablen:

• FINDTIME_TIME_API_BASE_URL

• TIME_API_BASE_URL

• TIME_API_TIMEOUT_MS

• FINDTIME_BINDING_TYPE für optionalen Installations-/Workspace-Bindungskontext. Unterstützte Werte: slack_team, workspace_id, install_id.

• FINDTIME_BINDING_VALUE für die Installations-/Workspace-Kennung, die zum ausgewählten Bindungstyp passt.

• FINDTIME_BINDING_HEADER zum direkten Überschreiben des Header-Namens für benutzerdefinierte Unternehmensumgebungen.

• FINDTIME_MCP_CLIENT_ID oder FINDTIME_MCP_INSTALL_ID, um eine stabile Client-Kennung bereitzustellen. Wenn nicht angegeben, erstellt der Server lokal eine unter dem Benutzerstatusverzeichnis. Wenn vorhanden, leitet der MCP-Wrapper sie als X-Findtime-User-ID an time-api weiter, um die Nutzung im Unternehmen zuzuordnen.

• FINDTIME_MCP_CLIENT_TYPE

• FINDTIME_MCP_TOOL_MODE=answer-only, um nur answer_time_question, get_findtime_help und get_api_diagnostics für Unternehmens-Bots verfügbar zu machen, die jede natürliche Sprachaufforderung über die Antwort-API leiten sollen.

• FINDTIME_MCP_INSTRUMENTATION_ENABLED=false, um sich von anonymer Nutzungstelemetrie abzumelden.

• FINDTIME_MCP_USAGE_TELEMETRY_URL, um den Standard-Telemetrie-Endpunkt zu überschreiben.

Pro-Aufruf-Zuordnung des Endbenutzers

Multi-User-MCP-Hosts wie Slack-, Discord- und Teams-Bots können einen langlebigen @findtime/mcp-server-Subprozess ausführen und dennoch jeden Time-API-Aufruf dem Endbenutzer zuordnen, der ihn ausgelöst hat. Fügen Sie ein optionales _endUserId-Feld im arguments-Objekt des MCP-Tool-Aufrufs hinzu. Der Server entfernt _endUserId aus den Tool-Parametern und leitet es nur als HTTP-Header X-Findtime-End-User-ID weiter.

await client.callTool({
  name: "get_current_time",
  arguments: {
    city: "Tokyo",
    _endUserId: "a3f2c1d4e5b6c7d8"
  }
});

Das Feld ist optional und abwärtskompatibel. Wenn _endUserId fehlt, null oder ein leerer String ist, wird der Header weggelassen und die Zuordnung fällt auf das Installationsverhalten von FINDTIME_MCP_CLIENT_ID oder FINDTIME_MCP_INSTALL_ID zurück.

Datenschutzvertrag: _endUserId muss ein undurchsichtiges Token sein, das vom MCP-Host bereitgestellt wird, typischerweise ein SHA-256-Hash der Plattform-Benutzer-ID, gekürzt auf 16–32 Hexadezimalzeichen. Senden Sie keine rohen E-Mail-Adressen, Namen, Slack-/Discord-/Teams-IDs oder andere personenbezogene Daten. Die Vermeidung personenbezogener Daten in diesem Feld liegt in der Verantwortung der Host-Anwendung.

Der Server validiert _endUserId defensiv: Es muss ein String sein, höchstens 256 Zeichen lang und darf keine CR-, LF- oder andere Steuerzeichen enthalten. Der Rohwert wird vom Server nie protokolliert.

Cursor

{
  "mcpServers": {
    "findtime": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@findtime/mcp-server"],
      "env": {
        "FINDTIME_MCP_CLIENT_TYPE": "cursor",
        "FINDTIME_TIME_API_BASE_URL": "https://time-api.findtime.io",
        "FINDTIME_TIME_API_KEY": "YOUR_FINDTIME_SECRET_KEY"
      }
    }
  }
}

Codex

[mcp_servers.findtime]
command = "npx"
args = ["-y", "@findtime/mcp-server"]
enabled = true

[mcp_servers.findtime.env]
FINDTIME_MCP_CLIENT_TYPE = "codex"
FINDTIME_TIME_API_BASE_URL = "https://time-api.findtime.io"
FINDTIME_TIME_API_KEY = "YOUR_FINDTIME_SECRET_KEY"
# Optional enterprise install binding:
# FINDTIME_BINDING_TYPE = "workspace_id"
# FINDTIME_BINDING_VALUE = "YOUR_WORKSPACE_ID"

Claude Desktop

{
  "preferences": {
    "...": "keep your existing preferences here"
  },
  "mcpServers": {
    "findtime": {
      "command": "npx",
      "args": ["-y", "@findtime/mcp-server"],
        "env": {
          "FINDTIME_TIME_API_BASE_URL": "https://time-api.findtime.io",
          "FINDTIME_TIME_API_KEY": "YOUR_FINDTIME_SECRET_KEY"
        }
      }
    }
  }

Claude CLI / Claude Code

Fügen Sie findtime.io hinzu mit:

claude mcp add --transport stdio \
  --env FINDTIME_TIME_API_BASE_URL=https://time-api.findtime.io \
  --env FINDTIME_TIME_API_KEY=YOUR_FINDTIME_SECRET_KEY \
  --env FINDTIME_MCP_CLIENT_TYPE=claude-cli \
  findtime -- npx -y @findtime/mcp-server

Wenn Ihre Claude-CLI stattdessen eine JSON-Konfiguration verwendet, fügen Sie hinzu:

{
  "mcpServers": {
    "findtime": {
      "command": "npx",
      "args": ["-y", "@findtime/mcp-server"],
      "env": {
        "FINDTIME_TIME_API_BASE_URL": "https://time-api.findtime.io",
        "FINDTIME_TIME_API_KEY": "YOUR_FINDTIME_SECRET_KEY",
        "FINDTIME_MCP_CLIENT_TYPE": "claude-cli"
      }
    }
  }
}

Für Unternehmensinstallationen ist die Mindestanforderung immer der API-Schlüssel. Wenn die Installationsumgebung eine stabile Workspace- oder Installationskennung hat, fügen Sie optional hinzu:

FINDTIME_BINDING_TYPE=workspace_id
FINDTIME_BINDING_VALUE=YOUR_WORKSPACE_ID

Für Slack-spezifische Installationen:

FINDTIME_BINDING_TYPE=slack_team
FINDTIME_BINDING_VALUE=T01ABC123

Installation überprüfen

Verwenden Sie zuerst eine explizite Tool-Aufruf-Aufforderung:

Use the findtime.io MCP tool get_api_diagnostics.

Dann:

Use the findtime.io MCP tool get_current_time for city "Tokyo" with countryCode "JP".

Nachdem dies erfolgreich war, wechseln Sie zurück zu normalen natürlichen Sprachaufforderungen:

Best meeting time between New York, Sydney, and Mumbai?

Lokale Entwicklung

Führen Sie die Workspace-Version direkt aus:

npm run mcp:start

Der Server versucht, .env.development.local, .env.development, .env.local und .env zu laden von:

• dem aktuellen Arbeitsverzeichnis

• services/mcp-server

• dem Repository-Stammverzeichnis

Tests

Protokoll- und Transporttests:

npm run test:mcp-server

Live-Produktionsparitäts-Smoke-Tests:

npm run test:mcp-server:smoke

Die Smoke-Suite prüft:

• search_timezones

• answer_time_question

• get_current_time

• get_dst_schedule

• convert_time

• get_overlap_hours

• find_meeting_time

• get_location_by_id

Wartungs-Release-Ablauf

Die kanonische öffentliche Quelle für dieses Paket liegt jetzt in:

• GitHub: https://github.com/hkchao/findtime-mcp-server

• npm: @findtime/mcp-server

• Offizielles MCP-Registry: https://registry.modelcontextprotocol.io/?q=io.github.hkchao%2Ffindtime-mcp-server

Veröffentlichungen und Versionsaktualisierungen sollten aus diesem öffentlichen Repository erfolgen, nicht aus diesem privaten App-Repository.

Standard-Publish-Ablauf im öffentlichen Repository:

npm test
npm pack --dry-run
npm publish --access public

Die entsprechenden lokalen Verifikationsprüfungen in diesem Repository sind:

npm run test:mcp-server
npm run mcp:pack

Behandeln Sie dieses Repository als die Implementierungsquelle, die ursprünglich das MCP-Paket erzeugt hat, nicht als kanonische öffentliche Release-Quelle.