Metadata-Version: 2.4
Name: timebase-mcp
Version: 0.2.0
Summary: Model Context Protocol (MCP) server for TimeBase
Keywords: mcp,model-context-protocol,timebase,time-series,db,ai,llm
Author: EPAM Systems
License-Expression: Apache-2.0
License-File: LICENSE
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Database
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Dist: mcp[cli]>=1.28.1,<1.29.0
Requires-Dist: packaging>=26.0,<27.0
Requires-Dist: pydantic>=2.13.3,<2.14.0
Requires-Dist: pydantic-settings>=2.14.2,<2.15.0
Requires-Dist: pyjwt[crypto]>=2.13.0,<3.0.0
Requires-Dist: httpx>=0.28.1,<1.0.0
Requires-Dist: dxapi-ee===5.5.74 ; extra == 'all'
Requires-Dist: dxapi-ce===6.2.3 ; extra == 'all'
Requires-Dist: dxapi-ce===6.2.3 ; extra == 'community'
Requires-Dist: dxapi-ee===5.5.74 ; extra == 'enterprise'
Requires-Python: >=3.10, <3.15
Project-URL: Homepage, https://github.com/epam/TimeBase-MCP
Project-URL: Repository, https://github.com/epam/TimeBase-MCP
Project-URL: Documentation, https://github.com/epam/TimeBase-MCP#readme
Project-URL: Issues, https://github.com/epam/TimeBase-MCP/issues
Project-URL: Changelog, https://github.com/epam/TimeBase-MCP/releases
Provides-Extra: all
Provides-Extra: community
Provides-Extra: enterprise
Description-Content-Type: text/markdown

# TimeBase MCP

A [Model Context Protocol](https://modelcontextprotocol.io/introduction) server that lets a coding agent (Claude Code, VS Code, Cursor, Claude Desktop, etc.) explore and query [TimeBase](https://kb.timebase.info): 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](https://github.com/epam/TimeBase-Agent-Plugins#quickstart) |
| Manual local setup | [Local setup](docs/local-setup.md) |
| Deploy a shared remote MCP server | [Remote deployment](docs/remote-deployment.md) |
| Connect to a running remote server | [Connect to a remote server](docs/connect-remote.md) |

## Documentation

| Topic | Go to |
| - | - |
| Updating | [Local setup: Updating](docs/local-setup.md#updating) |
| Troubleshooting | [Troubleshooting](docs/troubleshooting.md) |
| Reference | [Environment variables, auth, capabilities](docs/reference/README.md) |

## See also

- [TimeBase Agent Plugins](https://github.com/epam/TimeBase-Agent-Plugins)
