monocle-apptrace 0.5.1__py3-none-any.whl → 0.5.1b1__py3-none-any.whl

monocle_apptrace/mcp_server.py

@@ -0,0 +1,94 @@
+import logging
+import click
+from mcp.server.fastmcp import FastMCP
+
+logger = logging.getLogger(__name__)
+
+app = FastMCP(
+    "monocle-mcp",
+)
+code_snippets = {
+    "python": "from monocle_apptrace import setup_monocle_telemetry"
+    "setup_monocle_telemetry(workflow_name='my_workflow')\n",
+    "typescript": "import { trace } from 'monocle';\n\ntrace();\n",
+}
+setup_instructions = {
+    "python": "pip install monocle_apptrace package and add monocle_apptrace at the end of the requirement.txt for future. This code snippet provided below should be just below other imports in your application code.",
+    "typescript": "Install monocle package and add the trace function call at the top of your application. This code snippet provided below should be just below other imports in your application code.",
+}
+
+description = {
+    "python": "This will automatically trace your Python application, capturing telemetry data for your genAI operations.",
+    "typescript": "This will automatically trace your TypeScript application, capturing telemetry data for your genAI operations.",
+}
+
+
+# Use the existing dictionaries to get language-specific information
+# code_snippet = code_snippets.get(app_language, code_snippets['python'])
+# instructions = setup_instructions.get(app_language, setup_instructions['python'])
+# desc = description.get(app_language, description['python'])
+enable_monocle_prompt = """Do following changes to the project:
+1. run command 'pip install monocle_apptrace'
+2. Add following line to  requirements.txt in current directory 'monocle_apptrace' if it's not there already
+3. Add following lines just below other imports in the file if it's not there already:
+from monocle_apptrace import setup_monocle_telemetry
+setup_monocle_telemetry(workflow_name=<module-name>, monocle_exporters_list='file'))
+"""
+
+monocle_trace_prompt: str = """
+You are a helpful assistant to analyze given Monocle trace data. Review the trace data and provide a summary of whether the execution was successful or if there were any errors. Your job is to analyze the trace data and provide a summary. Be very concise in reporting. Check for errors or problem situations. First provide a headline that indicates status of the trace and if there are problems. If there are problems, then provide a brief summary of the problems. If there are problems, then provide a brief summary of the root causes.
+Use the trace details provided below to understand the data.
+ 
+Monocle trace has recorded the traced the execution of a genAI application. Each step of the genAI operation is captured as span. The trace file is a JSON structure that is an array of span JSON elements. There's a root span that represents the overall execution context.
+The important span JSON elements are as follows:
+- context.trace_id is the unique id common for alls spans.
+- context.span_id is the unique id for each span.
+- parent_id indicates the parent span of that span. The span that has no parent is the root span.
+- status.status_code indicate the status of span. It can be OK or ERROR or UNSET. If the span status is ERROR, then it generally propogated to it's parent and all the way to the root span. This means the entire trace is in error. However, sometimes the parent span will handle the error (eg. if parent name indicagtes 'retry') and the trace will be successful, even though an individual span has error.
+- attributes captures various attributes involved in that span's operation
+    - attribute."span.type" indicates the type of operation
+        - When the span.type is "workflow", that span captures the summary of the entire application
+    - entity.[NUMBER] are the different entties involved in the operation, for example large language model, agent, tool etc
+    - entity.type indicates the type of that entity
+- events is an array that captures the details of the operation such as input, output and metadata
+    - events array element with name=data.input captures the input provided to the operation
+    - events array element with name=data.output captures the output generated by the operation
+    - events array element with name=metaata captures the metadata of the operation
+        - total_tokens is the count of tokens
+        - completion_tokens is the count of ouput tokens
+        - prompt_tokens is the count of input tokens
+        - finish_type indicates how the operation finished, for example stop sequence or max tokens etc. If the finish_type is not success and indicates problems such as max tokens, then the operation is not successful. Check the status of it's parent span and check if it's due to the finish type of this child span. In that case callout the root cause as the child span error for the parent span error.
+"""
+
+@app.prompt(name="enable_tracing")
+def enable_monocle_tracing_prompt(app_language: str = "python") -> str:
+    """Trace agentic code"""
+    return enable_monocle_prompt.format(app_language=app_language)
+
+
+@app.prompt(name="analyze")
+def analyze_monocle_tracing_prompt() -> str:
+    """Identify root cause from trace"""
+    return monocle_trace_prompt
+
+
+@click.command()
+@click.option(
+    "--log-level",
+    default="info",
+    help="Logging level (DEBUG, INFO, WARNING, ERROR, CRITICAL)",
+)
+def main(log_level: str) -> int:
+    # Configure logging
+    logging.basicConfig(
+        level=getattr(logging, log_level.upper()),
+        format="%(asctime)s - %(name)s - %(levelname)s - %(message)s",
+    )
+
+    # Run the FastMCP server using stdio transport
+    app.run(transport="stdio")
+    return 0
+
+
+if __name__ == "__main__":
+    main()  # type: ignore

{monocle_apptrace-0.5.1.dist-info → monocle_apptrace-0.5.1b1.dist-info}/METADATA

@@ -1,18 +1,23 @@
 Metadata-Version: 2.4
 Name: monocle_apptrace
-Version: 0.5.1
+Version: 0.5.1b1
 Summary: package with monocle genAI tracing
 Project-URL: Homepage, https://github.com/monocle2ai/monocle
 Project-URL: Issues, https://github.com/monocle2ai/monocle/issues
+Author-email: "Okahu Inc." <okahu-pypi@okahu.ai>
+License: Apache-2.0
 License-File: LICENSE
 License-File: NOTICE
-Classifier: License :: OSI Approved :: MIT License
+Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Requires-Python: >=3.8
+Requires-Dist: click==8.2.1
+Requires-Dist: mcp>=1.13.1
 Requires-Dist: opentelemetry-api>=1.21.0
 Requires-Dist: opentelemetry-instrumentation
 Requires-Dist: opentelemetry-sdk>=1.21.0
+Requires-Dist: pydantic>=2.11.7
 Requires-Dist: requests
 Requires-Dist: wrapt>=1.14.0
 Provides-Extra: aws
@@ -132,6 +137,26 @@ Benefits:
 See [Monocle user guide](Monocle_User_Guide.md) for more details.
   
 
+## Use Monocle MCP
+
+First install monocle-apptrace: pip install monocle-apptrace
+
+Open bash and run the following command to run the monocle mcp server with stdio:
+monocle_apptrace
+
+If you are using VS Code you can add following entry to your .vscode/mcp.json
+
+```json
+"monocle-mcp-server": {
+      "type": "stdio",
+      "command": "uvx",
+      "args": [
+         "monocle_apptrace"
+      ],
+      "env": {}
+   }
+```
+
 ## Roadmap 
 
 Goal of Monocle is to support tracing for apps written in *any language* with *any LLM orchestration or agentic framework* and built using models, vectors, agents or other components served up by *any cloud or model inference provider*. 

{monocle_apptrace-0.5.1.dist-info → monocle_apptrace-0.5.1b1.dist-info}/RECORD

@@ -1,6 +1,7 @@
 monocle_apptrace/README.md,sha256=T5NFC01bF8VR0oVnAX_n0bhsEtttwqfTxDNAe5Y_ivE,3765
 monocle_apptrace/__init__.py,sha256=XtoX7gHUSZgkY1nry8IFny8RslPhutZQUuEkqIrBzFQ,30
 monocle_apptrace/__main__.py,sha256=MLLPbC4YTp8O2wQrn8BROSZGvQpQd5brk_d1n_dWVWA,573
+monocle_apptrace/mcp_server.py,sha256=X5NFOE1QHkIktykGlRH-bzOnLsby5E9sTRAT-4BOQx0,5591
 monocle_apptrace/exporters/base_exporter.py,sha256=xm2MkDjuVZc-vmSXBMMsNMyIoy4z0O4g6wOAyuEnHwo,2062
 monocle_apptrace/exporters/exporter_processor.py,sha256=-spCIJ_UfJ0fax_jE-ii3ODQBwtnHZgYIGVNd91Q718,6298
 monocle_apptrace/exporters/file_exporter.py,sha256=bqRo1h9ubuUltYTj7-LxHWtPwlevBV6dvRbnJXQEwqs,7873
@@ -136,8 +137,9 @@ monocle_apptrace/instrumentation/metamodel/teamsai/entities/__init__.py,sha256=4
 monocle_apptrace/instrumentation/metamodel/teamsai/entities/inference/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 monocle_apptrace/instrumentation/metamodel/teamsai/entities/inference/actionplanner_output_processor.py,sha256=FRR9iBdDBXfYscP-lkORMNKl_lllflZN6gMlC7m_94w,3206
 monocle_apptrace/instrumentation/metamodel/teamsai/entities/inference/teamsai_output_processor.py,sha256=o9jrBIEqPDg3VfR6zexUCpkq3jlX0lQji8CKLUUK4Wk,3022
-monocle_apptrace-0.5.1.dist-info/METADATA,sha256=5zCg558h1uTrkzO6jupxY0Zt5KhmZGvK-vb9HmVCE9c,7424
-monocle_apptrace-0.5.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-monocle_apptrace-0.5.1.dist-info/licenses/LICENSE,sha256=ay9trLiP5I7ZsFXo6AqtkLYdRqe5S9r-DrPOvsNlZrg,9136
-monocle_apptrace-0.5.1.dist-info/licenses/NOTICE,sha256=9jn4xtwM_uUetJMx5WqGnhrR7MIhpoRlpokjSTlyt8c,112
-monocle_apptrace-0.5.1.dist-info/RECORD,,
+monocle_apptrace-0.5.1b1.dist-info/METADATA,sha256=ScYyK_Mw2BqC9Eyet78MFcoV3b7CwtQ3GHkseNJQd2o,8013
+monocle_apptrace-0.5.1b1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+monocle_apptrace-0.5.1b1.dist-info/entry_points.txt,sha256=rxpPKb3klrgZEbSyOFQ2J6KRPO7ri9ES-zmC8Jtikx8,70
+monocle_apptrace-0.5.1b1.dist-info/licenses/LICENSE,sha256=ay9trLiP5I7ZsFXo6AqtkLYdRqe5S9r-DrPOvsNlZrg,9136
+monocle_apptrace-0.5.1b1.dist-info/licenses/NOTICE,sha256=9jn4xtwM_uUetJMx5WqGnhrR7MIhpoRlpokjSTlyt8c,112
+monocle_apptrace-0.5.1b1.dist-info/RECORD,,

monocle_apptrace-0.5.1b1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+monocle_apptrace = monocle_apptrace.mcp_server:main