dc-mcp 0.1.4__tar.gz

dc_mcp-0.1.4/.gitignore

@@ -0,0 +1,306 @@
+
+# Created by https://www.toptal.com/developers/gitignore/api/macos,python,pycharm
+# Edit at https://www.toptal.com/developers/gitignore?templates=macos,python,pycharm
+
+### macOS ###
+# General
+.DS_Store
+.AppleDouble
+.LSOverride
+
+# Icon must end with two \r
+Icon
+
+
+# Thumbnails
+._*
+
+# Files that might appear in the root of a volume
+.DocumentRevisions-V100
+.fseventsd
+.Spotlight-V100
+.TemporaryItems
+.Trashes
+.VolumeIcon.icns
+.com.apple.timemachine.donotpresent
+
+# Directories potentially created on remote AFP share
+.AppleDB
+.AppleDesktop
+Network Trash Folder
+Temporary Items
+.apdisk
+
+### PyCharm ###
+# Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio, WebStorm and Rider
+# Reference: https://intellij-support.jetbrains.com/hc/en-us/articles/206544839
+
+.idea
+
+# User-specific stuff
+.idea/**/workspace.xml
+.idea/**/tasks.xml
+.idea/**/usage.statistics.xml
+.idea/**/dictionaries
+.idea/**/shelf
+
+# Generated files
+.idea/**/contentModel.xml
+
+# Sensitive or high-churn files
+.idea/**/dataSources/
+.idea/**/dataSources.ids
+.idea/**/dataSources.local.xml
+.idea/**/sqlDataSources.xml
+.idea/**/dynamic.xml
+.idea/**/uiDesigner.xml
+.idea/**/dbnavigator.xml
+
+# Gradle
+.idea/**/gradle.xml
+.idea/**/libraries
+
+# Gradle and Maven with auto-import
+# When using Gradle or Maven with auto-import, you should exclude module files,
+# since they will be recreated, and may cause churn.  Uncomment if using
+# auto-import.
+# .idea/artifacts
+# .idea/compiler.xml
+# .idea/jarRepositories.xml
+# .idea/modules.xml
+# .idea/*.iml
+# .idea/modules
+# *.iml
+# *.ipr
+
+# CMake
+cmake-build-*/
+
+# Mongo Explorer plugin
+.idea/**/mongoSettings.xml
+
+# File-based project format
+*.iws
+
+# IntelliJ
+out/
+
+# mpeltonen/sbt-idea plugin
+.idea_modules/
+
+# JIRA plugin
+atlassian-ide-plugin.xml
+
+# Cursive Clojure plugin
+.idea/replstate.xml
+
+# Crashlytics plugin (for Android Studio and IntelliJ)
+com_crashlytics_export_strings.xml
+crashlytics.properties
+crashlytics-build.properties
+fabric.properties
+
+# Editor-based Rest Client
+.idea/httpRequests
+
+# Android studio 3.1+ serialized cache file
+.idea/caches/build_file_checksums.ser
+
+### PyCharm Patch ###
+# Comment Reason: https://github.com/joeblau/gitignore.io/issues/186#issuecomment-215987721
+
+# *.iml
+# modules.xml
+# .idea/misc.xml
+# *.ipr
+
+# Sonarlint plugin
+# https://plugins.jetbrains.com/plugin/7973-sonarlint
+.idea/**/sonarlint/
+
+# SonarQube Plugin
+# https://plugins.jetbrains.com/plugin/7238-sonarqube-community-plugin
+.idea/**/sonarIssues.xml
+
+# Markdown Navigator plugin
+# https://plugins.jetbrains.com/plugin/7896-markdown-navigator-enhanced
+.idea/**/markdown-navigator.xml
+.idea/**/markdown-navigator-enh.xml
+.idea/**/markdown-navigator/
+
+# Cache file creation bug
+# See https://youtrack.jetbrains.com/issue/JBR-2257
+.idea/$CACHE_FILE$
+
+# CodeStream plugin
+# https://plugins.jetbrains.com/plugin/12206-codestream
+.idea/codestream.xml
+
+### Python ###
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+pytestdebug.log
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+doc/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#poetry.lock
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.env/
+.venv/
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+pythonenv*
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# operating system-related files
+# file properties cache/storage on macOS
+*.DS_Store
+# thumbnail cache on Windows
+Thumbs.db
+
+# profiling data
+.prof
+
+
+# End of https://www.toptal.com/developers/gitignore/api/macos,python,pycharm
+/cdk.out/
+
+/agentcore/build/
+memory-bank/
+.cursor/
+
+# GraphQL KB generated files
+schema-docs-v2/
+schema-docs-old/
+
+
+# VS Code
+.vscode/launch.json
+
+
+# schema-docs-v2
+schema-docs-v2/
+schema-docs-old/

dc_mcp-0.1.4/PKG-INFO

@@ -0,0 +1,28 @@
+Metadata-Version: 2.4
+Name: dc-mcp
+Version: 0.1.4
+Summary: MCP client for the DoControl multi-agent assistant. Bridges Cursor (stdio) to the DoControl AgentCore gateway with Cognito authentication.
+Project-URL: Homepage, https://docontrol.io
+Project-URL: Repository, https://github.com/docontrol-io/dot
+Author: DoControl
+License: MIT
+Keywords: ai,cursor,docontrol,mcp,saas-security
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+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: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27
+Requires-Dist: keyring>=24.0
+Requires-Dist: mcp>=1.0
+Requires-Dist: pydantic-settings>=2.0
+Requires-Dist: pydantic>=2.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest-httpx>=0.30; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'

dc_mcp-0.1.4/README.md

@@ -0,0 +1,111 @@
+# dc-mcp
+
+Stdio MCP (Model Context Protocol) client for the DoControl multi-agent assistant. Connect Cursor (or any MCP-compatible client) to your DoControl tenant in under 60 seconds.
+
+## Quick start
+
+### 1. Install uv (one-time, if not already installed)
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+```
+
+### 2. Authenticate with your DoControl refresh token
+
+```bash
+uvx dc-mcp login
+```
+
+### 3. Add to `~/.cursor/mcp.json`
+
+```jsonc
+{
+  "mcpServers": {
+    "docontrol": {
+      "command": "uvx",
+      "args": ["dc-mcp"]
+    }
+  }
+}
+```
+
+Then restart Cursor. The DoControl tools will appear in the chat sidebar.
+
+## Get your refresh token
+
+Log in to https://app.docontrol.io, navigate to **Settings → Integrations → MCP Token**, and click **Generate**. The token is valid for 30 days; you can regenerate it at any time.
+
+When your token expires, simply run `uvx dc-mcp login` again with the new refresh token.
+
+## CLI reference
+
+| Command | What it does |
+| --- | --- |
+| `dc-mcp` | Run the stdio MCP server (this is what Cursor invokes) |
+| `dc-mcp login` | Store a refresh token in your OS keychain |
+| `dc-mcp logout` | Clear the stored refresh token |
+| `dc-mcp whoami` | Show your current authentication info |
+| `dc-mcp --version` | Print the installed version |
+| `dc-mcp --help` | Show CLI help |
+
+## CI / headless / corporate environments
+
+For environments where the OS keychain is unavailable (CI runners, headless Linux containers, devcontainers without Secret Service), set the refresh token via environment variable:
+
+```bash
+export DOCONTROL_REFRESH_TOKEN="..."
+```
+
+Then configure your MCP server to pass it through:
+
+```jsonc
+{
+  "mcpServers": {
+    "docontrol": {
+      "command": "uvx",
+      "args": ["dc-mcp"],
+      "env": {
+        "DOCONTROL_REFRESH_TOKEN": "${env:DOCONTROL_REFRESH_TOKEN}"
+      }
+    }
+  }
+}
+```
+
+The environment variable takes priority over the keychain when both are set.
+
+## Troubleshooting
+
+**`error: Refresh token expired or revoked`**  
+Your refresh token is older than 30 days or has been revoked. Generate a new one in the DoControl webapp and run `dc-mcp login` again.
+
+**`Network error contacting Cognito ... Check your internet connection or corporate proxy`**  
+You're behind a corporate firewall. Set `HTTPS_PROXY` to your proxy URL (e.g., `export HTTPS_PROXY=http://proxy.company.com:8080`).
+
+**`Keychain unavailable: ... On headless Linux, set DOCONTROL_REFRESH_TOKEN env var instead`**  
+Your environment doesn't have a usable OS keychain (common in headless Linux or devcontainers). Use the environment variable approach from the CI section above.
+
+**`No refresh token found`**  
+Either run `dc-mcp login` to store a token in your keychain, or set the `DOCONTROL_REFRESH_TOKEN` environment variable.
+
+**No DoControl tools appear in Cursor**  
+Verify the syntax of `~/.cursor/mcp.json`, restart Cursor, then check **Cursor Settings → MCP** for connection errors. Run `dc-mcp whoami` to confirm your authentication is healthy.
+
+**`uvx: command not found`**  
+Install uv with `curl -LsSf https://astral.sh/uv/install.sh | sh` and restart your shell.
+
+## Privacy and security
+
+Refresh tokens are stored in your OS keychain (macOS Keychain, Windows Credential Vault, or Linux Secret Service). They never leave your machine other than to be exchanged with Cognito for short-lived access tokens.
+
+Each request to DoControl uses a fresh access token with a one-hour time-to-live (TTL). All traffic is HTTPS to AWS-hosted endpoints. No telemetry is collected by the package.
+
+To revoke access, run `dc-mcp logout` to clear the local token, and revoke server-side via the DoControl webapp's **Integrations** panel.
+
+## Development & contributing
+
+This package is part of the [docontrol-io/dot](https://github.com/docontrol-io/dot) repository. To report issues, file a GitHub issue in the main repo. For implementation details and testing, see the package source in `packages/docontrol-mcp/src/` and tests in `packages/docontrol-mcp/tests/`.
+
+## License
+
+MIT — see [LICENSE](../../LICENSE) in the repository root.

dc_mcp-0.1.4/pyproject.toml

@@ -0,0 +1,48 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "dc-mcp"
+version = "0.1.4"
+description = "MCP client for the DoControl multi-agent assistant. Bridges Cursor (stdio) to the DoControl AgentCore gateway with Cognito authentication."
+requires-python = ">=3.10"
+license = {text = "MIT"}
+authors = [{name = "DoControl"}]
+keywords = ["mcp", "docontrol", "cursor", "ai", "saas-security"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+
+dependencies = [
+    "mcp >= 1.0",
+    "httpx >= 0.27",
+    "keyring >= 24.0",
+    "pydantic >= 2.0",
+    "pydantic-settings >= 2.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest >= 8.0",
+    "pytest-httpx >= 0.30",
+    "pytest-asyncio >= 0.23",
+]
+
+[project.scripts]
+dc-mcp = "docontrol_mcp_client.cli:main"
+
+[project.urls]
+Homepage = "https://docontrol.io"
+Repository = "https://github.com/docontrol-io/dot"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/docontrol_mcp_client"]

dc_mcp-0.1.4/pyrightconfig.json

@@ -0,0 +1,23 @@
+{
+    "include": [
+        "src",
+        "tests"
+    ],
+    "exclude": [
+        "**/__pycache__",
+        "**/.*",
+        ".venv",
+        "dist",
+        "build"
+    ],
+    "extraPaths": [
+        "./src"
+    ],
+    "venvPath": ".",
+    "venv": ".venv",
+    "pythonVersion": "3.10",
+    "pythonPlatform": "Darwin",
+    "typeCheckingMode": "standard",
+    "useLibraryCodeForTypes": true,
+    "autoImportCompletions": true
+}

dc_mcp-0.1.4/src/docontrol_mcp_client/__init__.py

@@ -0,0 +1,17 @@
+"""DoControl MCP client. See README for usage."""
+
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    # ``pyproject.toml`` is the single source of truth. Hatchling stamps
+    # the version into the installed dist's ``METADATA`` at build time, so
+    # ``--version`` and the MCP ``Server(version=...)`` handshake always
+    # mirror what was actually shipped — no parallel literal to keep in
+    # sync. Previously this file held a hardcoded ``"0.1.0"`` that drifted
+    # behind ``pyproject.toml`` (0.1.3) and silently lied to ``--version``.
+    __version__ = version("dc-mcp")
+except PackageNotFoundError:
+    # Source-tree usage without an installed wheel (a fresh checkout
+    # before ``pip install -e .``). Surfacing the misconfig as an obviously
+    # fake version is more useful than guessing or crashing.
+    __version__ = "0.0.0+unknown"

dc_mcp-0.1.4/src/docontrol_mcp_client/__main__.py

@@ -0,0 +1,6 @@
+"""Entry point for `python -m docontrol_mcp_client`."""
+
+from docontrol_mcp_client.cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())