somm-mcp 0.6.1__tar.gz

somm_mcp-0.6.1/.gitignore

@@ -0,0 +1,38 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+*.egg
+build/
+dist/
+
+# Environments
+.venv/
+.env
+.env.*
+
+# Tooling caches
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+
+# Local Claude session id log (per-machine, not source of truth)
+sessions.txt
+
+# Local data (never commit telemetry)
+.somm/
+*.sqlite
+*.sqlite-wal
+*.sqlite-shm
+
+# Author-local notes not for open source
+notes/
+.claude/
+
+# Editor
+.vscode/
+.idea/
+*.swp
+
+# Archived internal design/process docs (see docs/BLUEPRINT.md for the public design doc)

somm_mcp-0.6.1/PKG-INFO

@@ -0,0 +1,34 @@
+Metadata-Version: 2.4
+Name: somm-mcp
+Version: 0.6.1
+Summary: somm MCP server — exposes telemetry + recommendations to coding agents
+Project-URL: Homepage, https://github.com/lavallee/somm
+Project-URL: Repository, https://github.com/lavallee/somm
+Project-URL: Issues, https://github.com/lavallee/somm/issues
+Project-URL: Changelog, https://github.com/lavallee/somm/blob/main/CHANGELOG.md
+Author: Marc Lavallee
+License: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.12
+Requires-Dist: mcp>=1.2
+Requires-Dist: somm-core==0.6.1
+Requires-Dist: somm==0.6.1
+Description-Content-Type: text/markdown
+
+# somm-mcp
+
+MCP server for [somm](https://github.com/lavallee/somm) — lets
+MCP-capable coding agents (Claude Code, Cursor, Windsurf) query your
+real LLM telemetry and the cross-project sommelier.
+
+Ships 10 stdio tools: somm_stats, somm_search_calls, somm_recommend,
+somm_register_workload, somm_register_prompt, somm_compare,
+somm_replay, somm_advise, somm_record_decision, somm_search_decisions.
+
+```json
+{ "command": "somm-mcp", "env": { "SOMM_PROJECT": "my_app" } }
+```

somm_mcp-0.6.1/README.md

@@ -0,0 +1,13 @@
+# somm-mcp
+
+MCP server for [somm](https://github.com/lavallee/somm) — lets
+MCP-capable coding agents (Claude Code, Cursor, Windsurf) query your
+real LLM telemetry and the cross-project sommelier.
+
+Ships 10 stdio tools: somm_stats, somm_search_calls, somm_recommend,
+somm_register_workload, somm_register_prompt, somm_compare,
+somm_replay, somm_advise, somm_record_decision, somm_search_decisions.
+
+```json
+{ "command": "somm-mcp", "env": { "SOMM_PROJECT": "my_app" } }
+```

somm_mcp-0.6.1/pyproject.toml

@@ -0,0 +1,36 @@
+[project]
+name = "somm-mcp"
+version = "0.6.1"
+description = "somm MCP server — exposes telemetry + recommendations to coding agents"
+requires-python = ">=3.12"
+license = { text = "MIT" }
+readme = "README.md"
+authors = [{ name = "Marc Lavallee" }]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries",
+]
+dependencies = [
+    "somm-core==0.6.1",
+    "somm==0.6.1",
+    "mcp>=1.2",
+]
+
+[project.scripts]
+somm-mcp = "somm_mcp.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/lavallee/somm"
+Repository = "https://github.com/lavallee/somm"
+Issues = "https://github.com/lavallee/somm/issues"
+Changelog = "https://github.com/lavallee/somm/blob/main/CHANGELOG.md"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/somm_mcp"]

somm_mcp-0.6.1/src/somm_mcp/__init__.py

@@ -0,0 +1,13 @@
+"""somm-mcp — MCP server exposing somm telemetry + recommendations.
+
+Ships 10 stdio tools: `somm_stats`, `somm_search_calls`, `somm_recommend`,
+`somm_register_workload`, `somm_register_prompt`, `somm_compare`,
+`somm_replay`, `somm_advise`, `somm_record_decision`,
+`somm_search_decisions`.
+
+Transport: stdio (direct to somm-core).
+"""
+
+from somm_mcp.server import build_server
+
+__all__ = ["build_server"]

somm_mcp-0.6.1/src/somm_mcp/cli.py

@@ -0,0 +1,39 @@
+"""`somm-mcp` CLI — runs the stdio MCP server with the full provider chain."""
+
+from __future__ import annotations
+
+import argparse
+import sys
+
+from somm_core.config import Config
+from somm_core.config import load as load_config
+
+
+def build_parser() -> argparse.ArgumentParser:
+    p = argparse.ArgumentParser(prog="somm-mcp", description="somm MCP server (stdio)")
+    p.add_argument("--project", default=None)
+    return p
+
+
+def _providers_from_config(cfg: Config):
+    """Build the default provider chain — the exact chain SommLLM builds,
+    so somm_compare / somm_replay can reach every provider the library can
+    (including gemini, deepseek, perplexity, and the CLI executors)."""
+    from somm.client import build_default_providers
+
+    return build_default_providers(cfg)
+
+
+def main(argv: list[str] | None = None) -> int:
+    from somm_mcp.server import build_server
+
+    args = build_parser().parse_args(argv)
+    cfg = load_config(project=args.project)
+    providers = _providers_from_config(cfg)
+    server = build_server(cfg, providers=providers)
+    server.run()
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())