English Français العربية

TimeBase

السجل الرسمي أخرى

Explore and query TimeBase streams, schemas, QQL, symbols, and server status via MCP.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package timebase-mcp
Claude Code 
claude mcp add timebase -e 'TIMEBASE_URL=dxtick://localhost:8011' -e 'TIMEBASE_SERVERS=<TIMEBASE_SERVERS>' -e 'TIMEBASE_USERNAME=<TIMEBASE_USERNAME>' -e 'TIMEBASE_PASSWORD=<your timebase_password>' -e 'TIMEBASE_OAUTH2_TOKEN_URL=<TIMEBASE_OAUTH2_TOKEN_URL>' -e 'TIMEBASE_OAUTH2_CLIENT_ID=<TIMEBASE_OAUTH2_CLIENT_ID>' -e 'TIMEBASE_OAUTH2_CLIENT_SECRET=<your timebase_oauth2_client_secret>' -e 'TIMEBASE_OAUTH2_SCOPE=<TIMEBASE_OAUTH2_SCOPE>' -e 'MCP_LOG_LEVEL=INFO' -e 'TIMEBASE_AUTH_MODE=auto' -e 'MCP_HOST=127.0.0.1' -e 'MCP_PORT=8000' -- uvx timebase-mcp==0.2.7
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "timebase": {
            "command": "uvx",
            "args": [
                "timebase-mcp==0.2.7"
            ],
            "env": {
                "TIMEBASE_URL": "dxtick://localhost:8011",
                "TIMEBASE_SERVERS": "<TIMEBASE_SERVERS>",
                "TIMEBASE_USERNAME": "<TIMEBASE_USERNAME>",
                "TIMEBASE_PASSWORD": "<your timebase_password>",
                "TIMEBASE_OAUTH2_TOKEN_URL": "<TIMEBASE_OAUTH2_TOKEN_URL>",
                "TIMEBASE_OAUTH2_CLIENT_ID": "<TIMEBASE_OAUTH2_CLIENT_ID>",
                "TIMEBASE_OAUTH2_CLIENT_SECRET": "<your timebase_oauth2_client_secret>",
                "TIMEBASE_OAUTH2_SCOPE": "<TIMEBASE_OAUTH2_SCOPE>",
                "MCP_LOG_LEVEL": "INFO",
                "TIMEBASE_AUTH_MODE": "auto",
                "MCP_HOST": "127.0.0.1",
                "MCP_PORT": "8000"
            }
        }
    }
}

متغيرات البيئة

  • TIMEBASE_URL TimeBase native connection URL.
  • TIMEBASE_SERVERS Multi-server config as a JSON array string or path to a JSON file.
  • TIMEBASE_USERNAME Username for basic auth or oauth2_client_credentials.
  • TIMEBASE_PASSWORD سري Password for basic auth.
  • TIMEBASE_OAUTH2_TOKEN_URL OAuth2 token endpoint for service-account client credentials.
  • TIMEBASE_OAUTH2_CLIENT_ID OAuth2 client ID for service-account or interactive login.
  • TIMEBASE_OAUTH2_CLIENT_SECRET سري OAuth2 client secret for service-account auth.
  • TIMEBASE_OAUTH2_SCOPE OAuth2 scope(s) for service-account or interactive login.
  • MCP_LOG_LEVEL Log level: DEBUG, INFO, WARNING, ERROR, or CRITICAL.
  • TIMEBASE_AUTH_MODE Outbound auth: auto, none, basic, oauth2_client_credentials, interactive.
  • MCP_HOST Loopback host for interactive OAuth redirect in stdio mode.
  • MCP_PORT Loopback port for interactive OAuth redirect in stdio mode.
OCI package ghcr.io/epam/timebase-mcp:0.2.7
Claude Code 
claude mcp add timebase -e 'TIMEBASE_URL=dxtick://localhost:8011' -e 'TIMEBASE_SERVERS=<TIMEBASE_SERVERS>' -e 'TIMEBASE_USERNAME=<TIMEBASE_USERNAME>' -e 'TIMEBASE_PASSWORD=<your timebase_password>' -e 'TIMEBASE_OAUTH2_TOKEN_URL=<TIMEBASE_OAUTH2_TOKEN_URL>' -e 'TIMEBASE_OAUTH2_CLIENT_ID=<TIMEBASE_OAUTH2_CLIENT_ID>' -e 'TIMEBASE_OAUTH2_CLIENT_SECRET=<your timebase_oauth2_client_secret>' -e 'TIMEBASE_OAUTH2_SCOPE=<TIMEBASE_OAUTH2_SCOPE>' -e 'MCP_LOG_LEVEL=INFO' -e 'TIMEBASE_AUTH_MODE=auto' -e 'MCP_AUTH_PUBLIC_URL=<MCP_AUTH_PUBLIC_URL>' -e 'MCP_AUTH_AUDIENCE=<MCP_AUTH_AUDIENCE>' -e 'MCP_AUTH_API_KEYS_FILE=<MCP_AUTH_API_KEYS_FILE>' -- docker run -i --rm ghcr.io/epam/timebase-mcp:0.2.7
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "timebase": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/epam/timebase-mcp:0.2.7"
            ],
            "env": {
                "TIMEBASE_URL": "dxtick://localhost:8011",
                "TIMEBASE_SERVERS": "<TIMEBASE_SERVERS>",
                "TIMEBASE_USERNAME": "<TIMEBASE_USERNAME>",
                "TIMEBASE_PASSWORD": "<your timebase_password>",
                "TIMEBASE_OAUTH2_TOKEN_URL": "<TIMEBASE_OAUTH2_TOKEN_URL>",
                "TIMEBASE_OAUTH2_CLIENT_ID": "<TIMEBASE_OAUTH2_CLIENT_ID>",
                "TIMEBASE_OAUTH2_CLIENT_SECRET": "<your timebase_oauth2_client_secret>",
                "TIMEBASE_OAUTH2_SCOPE": "<TIMEBASE_OAUTH2_SCOPE>",
                "MCP_LOG_LEVEL": "INFO",
                "TIMEBASE_AUTH_MODE": "auto",
                "MCP_AUTH_PUBLIC_URL": "<MCP_AUTH_PUBLIC_URL>",
                "MCP_AUTH_AUDIENCE": "<MCP_AUTH_AUDIENCE>",
                "MCP_AUTH_API_KEYS_FILE": "<MCP_AUTH_API_KEYS_FILE>"
            }
        }
    }
}

متغيرات البيئة

  • TIMEBASE_URL TimeBase native connection URL.
  • TIMEBASE_SERVERS Multi-server config as a JSON array string or path to a JSON file.
  • TIMEBASE_USERNAME Username for basic auth or oauth2_client_credentials.
  • TIMEBASE_PASSWORD سري Password for basic auth.
  • TIMEBASE_OAUTH2_TOKEN_URL OAuth2 token endpoint for service-account client credentials.
  • TIMEBASE_OAUTH2_CLIENT_ID OAuth2 client ID for service-account or interactive login.
  • TIMEBASE_OAUTH2_CLIENT_SECRET سري OAuth2 client secret for service-account auth.
  • TIMEBASE_OAUTH2_SCOPE OAuth2 scope(s) for service-account or interactive login.
  • MCP_LOG_LEVEL Log level: DEBUG, INFO, WARNING, ERROR, or CRITICAL.
  • TIMEBASE_AUTH_MODE Outbound auth: auto, none, basic, oauth2_client_credentials, forward_identity.
  • MCP_AUTH_PUBLIC_URL Public HTTPS URL of this MCP endpoint (e.g. https://mcp.example.com/mcp).
  • MCP_AUTH_AUDIENCE Expected JWT audience for inbound IdP auth.
  • MCP_AUTH_API_KEYS_FILE Path to a hashed API-key store for inbound bearer-key auth.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. TimeBase MCP
  2. Which guide do I need?
  3. Documentation
  4. See also

TimeBase MCP

A Model Context Protocol server that lets a coding agent (Claude Code, VS Code, Cursor, Claude Desktop, etc.) explore and query TimeBase: list streams, read schemas and symbols, preview messages, run QQL queries, and inspect server status and activity.

The server can run two ways:

  • Locally, your agent launches timebase-mcp as a local process (stdio) that connects to your TimeBase.
  • Remotely, you deploy timebase-mcp as a shared HTTP service that multiple users connect their agents to.

Which guide do I need?

| You want to | Go to | | - | - | | Use TimeBase MCP locally (Cursor, VS Code, Claude Code/Desktop) | Agent Plugins Quickstart | | Manual local setup | Local setup | | Deploy a shared remote MCP server | Remote deployment | | Connect to a running remote server | Connect to a remote server | | Add optional WebAdmin inspection | Add WebAdmin access |

Documentation

| Topic | Go to | | - | - | | Updating | Local setup: Updating | | Troubleshooting | Troubleshooting | | Reference | Environment variables, auth, capabilities |

See also

الأسئلة الشائعة

ما هو TimeBase؟

Explore and query TimeBase streams, schemas, QQL, symbols, and server status via MCP.

كيف أثبّت TimeBase؟

يعمل على جهازك. في Claude Code: claude mcp add timebase -e 'TIMEBASE_URL=dxtick://localhost:8011' -e 'TIMEBASE_SERVERS=<TIMEBASE_SERVERS>' -e 'TIMEBASE_USERNAME=<TIMEBASE_USERNAME>' -e 'TIMEBASE_PASSWORD=<your timebase_password>' -e 'TIMEBASE_OAUTH2_TOKEN_URL=<TIMEBASE_OAUTH2_TOKEN_URL>' -e 'TIMEBASE_OAUTH2_CLIENT_ID=<TIMEBASE_OAUTH2_CLIENT_ID>' -e 'TIMEBASE_OAUTH2_CLIENT_SECRET=<your timebase_oauth2_client_secret>' -e 'TIMEBASE_OAUTH2_SCOPE=<TIMEBASE_OAUTH2_SCOPE>' -e 'MCP_LOG_LEVEL=INFO' -e 'TIMEBASE_AUTH_MODE=auto' -e 'MCP_HOST=127.0.0.1' -e 'MCP_PORT=8000' -- uvx timebase-mcp==0.2.7. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج TimeBase إلى مفتاح API؟

نعم. يتطلب TIMEBASE_PASSWORD, TIMEBASE_OAUTH2_CLIENT_SECRET، وتضبطها في إعداداته.

هل TimeBase مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص Apache-2.0.

من يصون TimeBase؟

ينشره epam. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.