Adaptive Graph of Thoughts MCP Server

MIT License

index.html

index.html•65.7 kB

<!doctype html> <html lang="en" class="no-js"> <head> <meta charset="utf-8"> <meta name="viewport" content="width=device-width,initial-scale=1"> <link rel="canonical" href="https://SaptaDey.github.io/Adaptive-Graph-of-Thoughts-MCP-server/extending_with_claude/"> <link rel="prev" href="../extending/custom_stages/"> <link rel="next" href="../CONTRIBUTING/"> <link rel="icon" href="../assets/images/favicon.png"> <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.6.14"> <title>Claude API Integration - Adaptive Graph of Thoughts Documentation</title> <link rel="stylesheet" href="../assets/stylesheets/main.342714a4.min.css"> <link rel="stylesheet" href="../assets/stylesheets/palette.06af60db.min.css"> <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin> <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"> <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style> <link rel="stylesheet" href="../assets/stylesheets/custom.css"> <script>__md_scope=new URL("..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script> </head> <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="teal" data-md-color-accent="amber"> <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off"> <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off"> <label class="md-overlay" for="__drawer"></label> <div data-md-component="skip"> <a href="#extending-adaptive-graph-of-thoughts-with-direct-claude-api-calls" class="md-skip"> Skip to content </a> </div> <div data-md-component="announce"> </div> <header class="md-header" data-md-component="header"> <nav class="md-header__inner md-grid" aria-label="Header"> <a href=".." title="Adaptive Graph of Thoughts Documentation" class="md-header__button md-logo" aria-label="Adaptive Graph of Thoughts Documentation" data-md-component="logo"> <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for="__drawer"> <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class="md-header__title" data-md-component="header-title"> <div class="md-header__ellipsis"> <div class="md-header__topic"> Adaptive Graph of Thoughts Documentation </div> <div class="md-header__topic" data-md-component="header-topic"> Claude API Integration </div> </div> </div> <form class="md-header__option" data-md-component="palette"> <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="teal" data-md-color-accent="amber" aria-label="Switch to dark mode" type="radio" name="__palette" id="__palette_0"> <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_1" hidden> <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg> </label> <input class="md-option" data-md-color-media="" data-md-color-scheme="slate" data-md-color-primary="blue-grey" data-md-color-accent="orange" aria-label="Switch to light mode" type="radio" name="__palette" id="__palette_1"> <label class="md-header__button md-icon" title="Switch to light mode" for="__palette_0" hidden> <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12s-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg> </label> </form> <script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script> <label class="md-header__button md-icon" for="__search"> <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class="md-search" data-md-component="search" role="dialog"> <label class="md-search__overlay" for="__search"></label> <div class="md-search__inner" role="search"> <form class="md-search__form" name="search"> <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required> <label class="md-search__icon md-icon" for="__search"> <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class="md-search__options" aria-label="Search"> <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1"> <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> <div class="md-search__suggest" data-md-component="search-suggest"></div> </form> <div class="md-search__output"> <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix> <div class="md-search-result" data-md-component="search-result"> <div class="md-search-result__meta"> Initializing search </div> <ol class="md-search-result__list" role="presentation"></ol> </div> </div> </div> </div> </div> <div class="md-header__source"> <a href="https://github.com/SaptaDey/Adaptive-Graph-of-Thoughts-MCP-server" title="Go to repository" class="md-source" data-md-component="source"> <div class="md-source__icon md-icon"> <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class="md-source__repository"> Adaptive-Graph-of-Thoughts-MCP-server </div> </a> </div> </nav> </header> <div class="md-container" data-md-component="container"> <nav class="md-tabs" aria-label="Tabs" data-md-component="tabs"> <div class="md-grid"> <ul class="md-tabs__list"> <li class="md-tabs__item"> <a href=".." class="md-tabs__link"> Home </a> </li> <li class="md-tabs__item"> <a href="../getting_started/" class="md-tabs__link"> Getting Started </a> </li> <li class="md-tabs__item"> <a href="../configuration/" class="md-tabs__link"> Configuration </a> </li> <li class="md-tabs__item"> <a href="../usage/" class="md-tabs__link"> Usage </a> </li> <li class="md-tabs__item"> <a href="../vscode_extension/" class="md-tabs__link"> VS Code Extension </a> </li> <li class="md-tabs__item"> <a href="../claude_action/" class="md-tabs__link"> Claude Desktop Action </a> </li> <li class="md-tabs__item"> <a href="../api/mcp_api/" class="md-tabs__link"> API Reference </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href="../extending/custom_stages/" class="md-tabs__link"> Extending Adaptive Graph of Thoughts </a> </li> <li class="md-tabs__item"> <a href="../CONTRIBUTING/" class="md-tabs__link"> Contributing </a> </li> <li class="md-tabs__item"> <a href="../ROADMAP/" class="md-tabs__link"> Roadmap </a> </li> </ul> </div> </nav> <main class="md-main" data-md-component="main"> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" > <div class="md-sidebar__scrollwrap"> <div class="md-sidebar__inner"> <nav class="md-nav md-nav--primary md-nav--lifted md-nav--integrated" aria-label="Navigation" data-md-level="0"> <label class="md-nav__title" for="__drawer"> <a href=".." title="Adaptive Graph of Thoughts Documentation" class="md-nav__button md-logo" aria-label="Adaptive Graph of Thoughts Documentation" data-md-component="logo"> <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Adaptive Graph of Thoughts Documentation </label> <div class="md-nav__source"> <a href="https://github.com/SaptaDey/Adaptive-Graph-of-Thoughts-MCP-server" title="Go to repository" class="md-source" data-md-component="source"> <div class="md-source__icon md-icon"> <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class="md-source__repository"> Adaptive-Graph-of-Thoughts-MCP-server </div> </a> </div> <ul class="md-nav__list" data-md-scrollfix> <li class="md-nav__item"> <a href=".." class="md-nav__link"> Home </a> </li> <li class="md-nav__item"> <a href="../getting_started/" class="md-nav__link"> Getting Started </a> </li> <li class="md-nav__item"> <a href="../configuration/" class="md-nav__link"> Configuration </a> </li> <li class="md-nav__item"> <a href="../usage/" class="md-nav__link"> Usage </a> </li> <li class="md-nav__item"> <a href="../vscode_extension/" class="md-nav__link"> VS Code Extension </a> </li> <li class="md-nav__item"> <a href="../claude_action/" class="md-nav__link"> Claude Desktop Action </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_7" > <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0"> API Reference </label> <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false"> <label class="md-nav__title" for="__nav_7"> API Reference </label> <ul class="md-nav__list" data-md-scrollfix> <li class="md-nav__item"> <a href="../api/mcp_api/" class="md-nav__link"> MCP API </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" checked> <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex=""> Extending Adaptive Graph of Thoughts </label> <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="true"> <label class="md-nav__title" for="__nav_8"> Extending Adaptive Graph of Thoughts </label> <ul class="md-nav__list" data-md-scrollfix> <li class="md-nav__item"> <a href="../extending/custom_stages/" class="md-nav__link"> Custom Stages </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc"> <label class="md-nav__link md-nav__link--active" for="__toc"> Claude API Integration </label> <a href="./" class="md-nav__link md-nav__link--active"> Claude API Integration </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class="md-nav__title" for="__toc"> Table of contents </label> <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix> <li class="md-nav__item"> <a href="#introduction" class="md-nav__link"> Introduction </a> </li> <li class="md-nav__item"> <a href="#configuration" class="md-nav__link"> Configuration </a> </li> <li class="md-nav__item"> <a href="#service-function-implementation-conceptual" class="md-nav__link"> Service Function Implementation (Conceptual) </a> </li> <li class="md-nav__item"> <a href="#custom-stage-example-conceptual" class="md-nav__link"> Custom Stage Example (Conceptual) </a> </li> <li class="md-nav__item"> <a href="#disclaimer" class="md-nav__link"> Disclaimer </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item"> <a href="../CONTRIBUTING/" class="md-nav__link"> Contributing </a> </li> <li class="md-nav__item"> <a href="../ROADMAP/" class="md-nav__link"> Roadmap </a> </li> </ul> </nav> </div> </div> </div> <div class="md-content" data-md-component="content"> <article class="md-content__inner md-typeset"> <h1 id="extending-adaptive-graph-of-thoughts-with-direct-claude-api-calls">Extending Adaptive Graph of Thoughts with Direct Claude API Calls</h1> <h2 id="introduction">Introduction</h2> Adaptive Graph of Thoughts's ASR-GoT (Automated Scientific Reasoning - Graph of Thoughts) pipeline is designed to be modular. While many reasoning tasks can be handled by its core stages, there might be scenarios where directly leveraging a powerful Large Language Model (LLM) like Anthropic's Claude can be beneficial for specific, complex sub-tasks or to use Claude as a specialized tool within the pipeline. This guide outlines how to configure Adaptive Graph of Thoughts for direct Claude API calls and provides conceptual examples for integrating these calls within custom service functions or ASR-GoT stages. <h2 id="configuration">Configuration</h2> To enable direct Claude API calls, you need to configure the <code>claude_api</code> section in your <code>config/settings.yaml</code> file. <div class="highlight"><pre><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a># config/settings.yaml (snippet) <a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a> <a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a># ... other settings ... <a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a> <a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a># Optional: Direct Claude API integration settings (if the app needs to call Claude API itself) <a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a>claude_api: <a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a> api_key: "env_var:CLAUDE_API_KEY" # Recommended: Load from environment variable CLAUDE_API_KEY <a id="__codelineno-0-8" name="__codelineno-0-8" href="#__codelineno-0-8"></a> # api_key: "your_actual_claude_api_key_here" # Alternatively, direct input (less secure) <a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a> default_model: "claude-3-opus-20240229" # Or any other Claude model you intend to use <a id="__codelineno-0-10" name="__codelineno-0-10" href="#__codelineno-0-10"></a> timeout_seconds: 120 # Timeout for API requests in seconds <a id="__codelineno-0-11" name="__codelineno-0-11" href="#__codelineno-0-11"></a> max_retries: 2 # Maximum number of retries for API requests </code></pre></div> Key Configuration Fields: <ul> <li><code>api_key</code> (Optional[str]):<ul> <li>Your API key for accessing the Claude API.</li> <li>Security Best Practice: It is strongly recommended to provide the API key via an environment variable named <code>CLAUDE_API_KEY</code>. The application is configured to recognize the <code>"env_var:CLAUDE_API_KEY"</code> string and substitute it with the actual value from the environment variable at runtime.</li> <li>Alternatively, for development or testing, you can directly paste your API key, but avoid this for production deployments.</li> <li>If not provided, any direct Claude API calls will fail.</li> </ul> </li> <li><code>default_model</code> (str):<ul> <li>The default Claude model to use for API calls (e.g., <code>"claude-3-opus-20240229"</code>, <code>"claude-3-sonnet-20240229"</code>).</li> <li>Default: <code>"claude-3-opus-20240229"</code></li> </ul> </li> <li><code>timeout_seconds</code> (int):<ul> <li>The timeout duration in seconds for waiting for a response from the Claude API.</li> <li>Default: <code>120</code></li> </ul> </li> <li><code>max_retries</code> (int):<ul> <li>The maximum number of times the application will attempt to retry a failed API request.</li> <li>Default: <code>2</code></li> </ul> </li> </ul> If the <code>claude_api</code> section is omitted or commented out, Adaptive Graph of Thoughts will not be able to make direct calls to the Claude API. The settings loader will treat <code>settings.claude_api</code> as <code>None</code>. <h2 id="service-function-implementation-conceptual">Service Function Implementation (Conceptual)</h2> You can create service functions or utility methods that encapsulate the logic for calling the Claude API. These functions can then be used by various parts of the application, such as custom ASR-GoT stages. Here's a conceptual example using <code>httpx</code> for asynchronous requests: <div class="highlight"><pre><code><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a># Hypothetical service function (e.g., in src/adaptive_graph_of_thoughts/services/claude_service.py) <a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a>import httpx <a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a>from typing import Optional, Dict, Any <a id="__codelineno-1-4" name="__codelineno-1-4" href="#__codelineno-1-4"></a>from loguru import logger <a id="__codelineno-1-5" name="__codelineno-1-5" href="#__codelineno-1-5"></a> <a id="__codelineno-1-6" name="__codelineno-1-6" href="#__codelineno-1-6"></a># Assuming 'settings' is the global AppSettings instance from src.adaptive_graph_of_thoughts.config <a id="__codelineno-1-7" name="__codelineno-1-7" href="#__codelineno-1-7"></a>from src.adaptive_graph_of_thoughts.config import settings <a id="__codelineno-1-8" name="__codelineno-1-8" href="#__codelineno-1-8"></a> <a id="__codelineno-1-9" name="__codelineno-1-9" href="#__codelineno-1-9"></a>CLAUDE_API_BASE_URL = "https://api.anthropic.com/v1" # Example base URL <a id="__codelineno-1-10" name="__codelineno-1-10" href="#__codelineno-1-10"></a> <a id="__codelineno-1-11" name="__codelineno-1-11" href="#__codelineno-1-11"></a>async def call_claude_api( <a id="__codelineno-1-12" name="__codelineno-1-12" href="#__codelineno-1-12"></a> prompt: str, <a id="__codelineno-1-13" name="__codelineno-1-13" href="#__codelineno-1-13"></a> system_prompt: Optional[str] = None, <a id="__codelineno-1-14" name="__codelineno-1-14" href="#__codelineno-1-14"></a> model_override: Optional[str] = None, <a id="__codelineno-1-15" name="__codelineno-1-15" href="#__codelineno-1-15"></a> max_tokens: int = 1024, <a id="__codelineno-1-16" name="__codelineno-1-16" href="#__codelineno-1-16"></a>) -> Optional[Dict[str, Any]]: <a id="__codelineno-1-17" name="__codelineno-1-17" href="#__codelineno-1-17"></a> """ <a id="__codelineno-1-18" name="__codelineno-1-18" href="#__codelineno-1-18"></a> Makes a conceptual call to the Claude API (e.g., messages endpoint). <a id="__codelineno-1-19" name="__codelineno-1-19" href="#__codelineno-1-19"></a> """ <a id="__codelineno-1-20" name="__codelineno-1-20" href="#__codelineno-1-20"></a> if not settings.claude_api or not settings.claude_api.api_key: <a id="__codelineno-1-21" name="__codelineno-1-21" href="#__codelineno-1-21"></a> logger.error("Claude API settings or API key is not configured.") <a id="__codelineno-1-22" name="__codelineno-1-22" href="#__codelineno-1-22"></a> return None <a id="__codelineno-1-23" name="__codelineno-1-23" href="#__codelineno-1-23"></a> <a id="__codelineno-1-24" name="__codelineno-1-24" href="#__codelineno-1-24"></a> api_key = settings.claude_api.api_key <a id="__codelineno-1-25" name="__codelineno-1-25" href="#__codelineno-1-25"></a> # Resolve environment variable if specified (Pydantic settings usually handle this, <a id="__codelineno-1-26" name="__codelineno-1-26" href="#__codelineno-1-26"></a> # but direct usage might need explicit resolution if not using Pydantic model directly for key) <a id="__codelineno-1-27" name="__codelineno-1-27" href="#__codelineno-1-27"></a> if api_key.startswith("env_var:"): <a id="__codelineno-1-28" name="__codelineno-1-28" href="#__codelineno-1-28"></a> env_var_name = api_key.split(":", 1)[1] <a id="__codelineno-1-29" name="__codelineno-1-29" href="#__codelineno-1-29"></a> import os <a id="__codelineno-1-30" name="__codelineno-1-30" href="#__codelineno-1-30"></a> api_key = os.getenv(env_var_name) <a id="__codelineno-1-31" name="__codelineno-1-31" href="#__codelineno-1-31"></a> if not api_key: <a id="__codelineno-1-32" name="__codelineno-1-32" href="#__codelineno-1-32"></a> logger.error(f"Environment variable {env_var_name} for Claude API key not set.") <a id="__codelineno-1-33" name="__codelineno-1-33" href="#__codelineno-1-33"></a> return None <a id="__codelineno-1-34" name="__codelineno-1-34" href="#__codelineno-1-34"></a> <a id="__codelineno-1-35" name="__codelineno-1-35" href="#__codelineno-1-35"></a> model_to_use = model_override or settings.claude_api.default_model <a id="__codelineno-1-36" name="__codelineno-1-36" href="#__codelineno-1-36"></a> timeout = settings.claude_api.timeout_seconds <a id="__codelineno-1-37" name="__codelineno-1-37" href="#__codelineno-1-37"></a> # Max retries would typically be handled by the HTTP client's retry mechanism or a wrapper. <a id="__codelineno-1-38" name="__codelineno-1-38" href="#__codelineno-1-38"></a> <a id="__codelineno-1-39" name="__codelineno-1-39" href="#__codelineno-1-39"></a> headers = { <a id="__codelineno-1-40" name="__codelineno-1-40" href="#__codelineno-1-40"></a> "x-api-key": api_key, <a id="__codelineno-1-41" name="__codelineno-1-41" href="#__codelineno-1-41"></a> "anthropic-version": "2023-06-01", # Required header <a id="__codelineno-1-42" name="__codelineno-1-42" href="#__codelineno-1-42"></a> "content-type": "application/json" <a id="__codelineno-1-43" name="__codelineno-1-43" href="#__codelineno-1-43"></a> } <a id="__codelineno-1-44" name="__codelineno-1-44" href="#__codelineno-1-44"></a> <a id="__codelineno-1-45" name="__codelineno-1-45" href="#__codelineno-1-45"></a> messages = [{"role": "user", "content": prompt}] <a id="__codelineno-1-46" name="__codelineno-1-46" href="#__codelineno-1-46"></a> <a id="__codelineno-1-47" name="__codelineno-1-47" href="#__codelineno-1-47"></a> payload = { <a id="__codelineno-1-48" name="__codelineno-1-48" href="#__codelineno-1-48"></a> "model": model_to_use, <a id="__codelineno-1-49" name="__codelineno-1-49" href="#__codelineno-1-49"></a> "messages": messages, <a id="__codelineno-1-50" name="__codelineno-1-50" href="#__codelineno-1-50"></a> "max_tokens": max_tokens, <a id="__codelineno-1-51" name="__codelineno-1-51" href="#__codelineno-1-51"></a> } <a id="__codelineno-1-52" name="__codelineno-1-52" href="#__codelineno-1-52"></a> if system_prompt: <a id="__codelineno-1-53" name="__codelineno-1-53" href="#__codelineno-1-53"></a> payload["system"] = system_prompt <a id="__codelineno-1-54" name="__codelineno-1-54" href="#__codelineno-1-54"></a> <a id="__codelineno-1-55" name="__codelineno-1-55" href="#__codelineno-1-55"></a> <a id="__codelineno-1-56" name="__codelineno-1-56" href="#__codelineno-1-56"></a> try: <a id="__codelineno-1-57" name="__codelineno-1-57" href="#__codelineno-1-57"></a> async with httpx.AsyncClient(timeout=timeout) as client: <a id="__codelineno-1-58" name="__codelineno-1-58" href="#__codelineno-1-58"></a> # Note: For production, consider more robust retry logic (e.g., with tenacity) <a id="__codelineno-1-59" name="__codelineno-1-59" href="#__codelineno-1-59"></a> # For simplicity, only one attempt is shown here. Max_retries from config is not used directly. <a id="__codelineno-1-60" name="__codelineno-1-60" href="#__codelineno-1-60"></a> response = await client.post(f"{CLAUDE_API_BASE_URL}/messages", headers=headers, json=payload) <a id="__codelineno-1-61" name="__codelineno-1-61" href="#__codelineno-1-61"></a> response.raise_for_status() # Raises HTTPStatusError for 4xx/5xx responses <a id="__codelineno-1-62" name="__codelineno-1-62" href="#__codelineno-1-62"></a> <a id="__codelineno-1-63" name="__codelineno-1-63" href="#__codelineno-1-63"></a> response_data = response.json() <a id="__codelineno-1-64" name="__codelineno-1-64" href="#__codelineno-1-64"></a> logger.debug(f"Claude API response: {response_data}") <a id="__codelineno-1-65" name="__codelineno-1-65" href="#__codelineno-1-65"></a> return response_data <a id="__codelineno-1-66" name="__codelineno-1-66" href="#__codelineno-1-66"></a> <a id="__codelineno-1-67" name="__codelineno-1-67" href="#__codelineno-1-67"></a> except httpx.HTTPStatusError as e: <a id="__codelineno-1-68" name="__codelineno-1-68" href="#__codelineno-1-68"></a> logger.error(f"Claude API request failed with status {e.response.status_code}: {e.response.text}") <a id="__codelineno-1-69" name="__codelineno-1-69" href="#__codelineno-1-69"></a> except httpx.RequestError as e: <a id="__codelineno-1-70" name="__codelineno-1-70" href="#__codelineno-1-70"></a> logger.error(f"Claude API request failed: {e}") <a id="__codelineno-1-71" name="__codelineno-1-71" href="#__codelineno-1-71"></a> except Exception as e: <a id="__codelineno-1-72" name="__codelineno-1-72" href="#__codelineno-1-72"></a> logger.error(f"An unexpected error occurred while calling Claude API: {e}") <a id="__codelineno-1-73" name="__codelineno-1-73" href="#__codelineno-1-73"></a> <a id="__codelineno-1-74" name="__codelineno-1-74" href="#__codelineno-1-74"></a> return None <a id="__codelineno-1-75" name="__codelineno-1-75" href="#__codelineno-1-75"></a> <a id="__codelineno-1-76" name="__codelineno-1-76" href="#__codelineno-1-76"></a># Example Usage (conceptual): <a id="__codelineno-1-77" name="__codelineno-1-77" href="#__codelineno-1-77"></a># async def main(): <a id="__codelineno-1-78" name="__codelineno-1-78" href="#__codelineno-1-78"></a># response = await call_claude_api("Explain quantum entanglement in simple terms.") <a id="__codelineno-1-79" name="__codelineno-1-79" href="#__codelineno-1-79"></a># if response and response.get("content"): <a id="__codelineno-1-80" name="__codelineno-1-80" href="#__codelineno-1-80"></a># print(response.get("content")[0].get("text")) <a id="__codelineno-1-81" name="__codelineno-1-81" href="#__codelineno-1-81"></a># main() </code></pre></div> Key points for the service function: * Reads configuration from <code>settings.claude_api</code>. * Handles API key resolution (especially if using the <code>env_var:</code> prefix manually, though Pydantic settings often handle this transparently when the <code>ClaudeAPIConfig</code> model is instantiated). * Uses an HTTP client (<code>httpx</code> in this example) to make the API call. * Sets necessary headers, including <code>x-api-key</code> and <code>anthropic-version</code>. * Sends a JSON payload appropriate for the target Claude API endpoint (e.g., <code>/v1/messages</code>). * Includes basic error handling for network issues or API errors. <h2 id="custom-stage-example-conceptual">Custom Stage Example (Conceptual)</h2> A custom ASR-GoT stage can leverage the service function described above to incorporate Claude's capabilities into the reasoning pipeline. <div class="highlight"><pre><code><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a># Hypothetical custom stage (e.g., in src/adaptive_graph_of_thoughts/domain/stages/custom_claude_stage.py) <a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a>from src.adaptive_graph_of_thoughts.domain.stages.base_stage import BaseStage, StageOutput <a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a>from src.adaptive_graph_of_thoughts.domain.models.common_types import GoTProcessorSessionData <a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a>from loguru import logger <a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a> <a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a># Assuming the service function is available, e.g.: <a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a># from src.adaptive_graph_of_thoughts.services.claude_service import call_claude_api <a id="__codelineno-2-8" name="__codelineno-2-8" href="#__codelineno-2-8"></a> <a id="__codelineno-2-9" name="__codelineno-2-9" href="#__codelineno-2-9"></a>class ClaudeQueryStage(BaseStage): <a id="__codelineno-2-10" name="__codelineno-2-10" href="#__codelineno-2-10"></a> stage_name = "ClaudeQueryStage" # Unique name for this stage type <a id="__codelineno-2-11" name="__codelineno-2-11" href="#__codelineno-2-11"></a> <a id="__codelineno-2-12" name="__codelineno-2-12" href="#__codelineno-2-12"></a> async def execute( <a id="__codelineno-2-13" name="__codelineno-2-13" href="#__codelineno-2-13"></a> self, <a id="__codelineno-2-14" name="__codelineno-2-14" href="#__codelineno-2-14"></a> current_session_data: GoTProcessorSessionData, <a id="__codelineno-2-15" name="__codelineno-2-15" href="#__codelineno-2-15"></a> ) -> StageOutput: <a id="__codelineno-2-16" name="__codelineno-2-16" href="#__codelineno-2-16"></a> """ <a id="__codelineno-2-17" name="__codelineno-2-17" href="#__codelineno-2-17"></a> Example stage that uses Claude to answer a query from the session data. <a id="__codelineno-2-18" name="__codelineno-2-18" href="#__codelineno-2-18"></a> """ <a id="__codelineno-2-19" name="__codelineno-2-19" href="#__codelineno-2-19"></a> output = StageOutput(stage_name=self.stage_name) <a id="__codelineno-2-20" name="__codelineno-2-20" href="#__codelineno-2-20"></a> <a id="__codelineno-2-21" name="__codelineno-2-21" href="#__codelineno-2-21"></a> # Get some input from the accumulated context <a id="__codelineno-2-22" name="__codelineno-2-22" href="#__codelineno-2-22"></a> # For example, a specific query or data piece generated by a previous stage <a id="__codelineno-2-23" name="__codelineno-2-23" href="#__codelineno-2-23"></a> query_for_claude = current_session_data.accumulated_context.get("query_for_claude", current_session_data.query) <a id="__codelineno-2-24" name="__codelineno-2-24" href="#__codelineno-2-24"></a> <a id="__codelineno-2-25" name="__codelineno-2-25" href="#__codelineno-2-25"></a> if not query_for_claude: <a id="__codelineno-2-26" name="__codelineno-2-26" href="#__codelineno-2-26"></a> output.error_message = "No query found for Claude in session data." <a id="__codelineno-2-27" name="__codelineno-2-27" href="#__codelineno-2-27"></a> logger.warning(output.error_message) <a id="__codelineno-2-28" name="__codelineno-2-28" href="#__codelineno-2-28"></a> return output <a id="__codelineno-2-29" name="__codelineno-2-29" href="#__codelineno-2-29"></a> <a id="__codelineno-2-30" name="__codelineno-2-30" href="#__codelineno-2-30"></a> logger.info(f"[{self.stage_name}] Calling Claude API for: {query_for_claude[:100]}...") <a id="__codelineno-2-31" name="__codelineno-2-31" href="#__codelineno-2-31"></a> <a id="__codelineno-2-32" name="__codelineno-2-32" href="#__codelineno-2-32"></a> # Conceptual: In a real implementation, call_claude_api would be imported <a id="__codelineno-2-33" name="__codelineno-2-33" href="#__codelineno-2-33"></a> # from its actual location (e.g., a services module). <a id="__codelineno-2-34" name="__codelineno-2-34" href="#__codelineno-2-34"></a> # For this example, we'll mock its existence. <a id="__codelineno-2-35" name="__codelineno-2-35" href="#__codelineno-2-35"></a> # claude_response_data = await call_claude_api(prompt=query_for_claude) <a id="__codelineno-2-36" name="__codelineno-2-36" href="#__codelineno-2-36"></a> <a id="__codelineno-2-37" name="__codelineno-2-37" href="#__codelineno-2-37"></a> # Mocked response for illustration: <a id="__codelineno-2-38" name="__codelineno-2-38" href="#__codelineno-2-38"></a> claude_response_data = { "content": [{"type": "text", "text": f"Mocked Claude response to: {query_for_claude}"}] } <a id="__codelineno-2-39" name="__codelineno-2-39" href="#__codelineno-2-39"></a> <a id="__codelineno-2-40" name="__codelineno-2-40" href="#__codelineno-2-40"></a> if claude_response_data and claude_response_data.get("content"): <a id="__codelineno-2-41" name="__codelineno-2-41" href="#__codelineno-2-41"></a> claude_text_response = claude_response_data.get("content")[0].get("text") <a id="__codelineno-2-42" name="__codelineno-2-42" href="#__codelineno-2-42"></a> logger.info(f"[{self.stage_name}] Received response from Claude.") <a id="__codelineno-2-43" name="__codelineno-2-43" href="#__codelineno-2-43"></a> <a id="__codelineno-2-44" name="__codelineno-2-44" href="#__codelineno-2-44"></a> # Add Claude's response to the accumulated context for subsequent stages <a id="__codelineno-2-45" name="__codelineno-2-45" href="#__codelineno-2-45"></a> output.next_stage_context_update = { <a id="__codelineno-2-46" name="__codelineno-2-46" href="#__codelineno-2-46"></a> self.stage_name: { # Key results under this stage's name <a id="__codelineno-2-47" name="__codelineno-2-47" href="#__codelineno-2-47"></a> "claude_response_text": claude_text_response, <a id="__codelineno-2-48" name="__codelineno-2-48" href="#__codelineno-2-48"></a> "status": "success" <a id="__codelineno-2-49" name="__codelineno-2-49" href="#__codelineno-2-49"></a> } <a id="__codelineno-2-50" name="__codelineno-2-50" href="#__codelineno-2-50"></a> } <a id="__codelineno-2-51" name="__codelineno-2-51" href="#__codelineno-2-51"></a> output.summary = f"Successfully queried Claude. Response: {claude_text_response[:100]}..." <a id="__codelineno-2-52" name="__codelineno-2-52" href="#__codelineno-2-52"></a> else: <a id="__codelineno-2-53" name="__codelineno-2-53" href="#__codelineno-2-53"></a> output.error_message = "Failed to get a valid response from Claude API." <a id="__codelineno-2-54" name="__codelineno-2-54" href="#__codelineno-2-54"></a> logger.error(f"[{self.stage_name}] {output.error_message}") <a id="__codelineno-2-55" name="__codelineno-2-55" href="#__codelineno-2-55"></a> output.next_stage_context_update = { <a id="__codelineno-2-56" name="__codelineno-2-56" href="#__codelineno-2-56"></a> self.stage_name: { <a id="__codelineno-2-57" name="__codelineno-2-57" href="#__codelineno-2-57"></a> "status": "failure", <a id="__codelineno-2-58" name="__codelineno-2-58" href="#__codelineno-2-58"></a> "error_message": output.error_message <a id="__codelineno-2-59" name="__codelineno-2-59" href="#__codelineno-2-59"></a> } <a id="__codelineno-2-60" name="__codelineno-2-60" href="#__codelineno-2-60"></a> } <a id="__codelineno-2-61" name="__codelineno-2-61" href="#__codelineno-2-61"></a> <a id="__codelineno-2-62" name="__codelineno-2-62" href="#__codelineno-2-62"></a> return output </code></pre></div> Key points for the custom stage: * It inherits from <code>BaseStage</code>. * It uses the <code>current_session_data</code> to get inputs. * It calls the <code>call_claude_api</code> service function. * It processes the response and updates <code>current_session_data.accumulated_context</code> via <code>StageOutput.next_stage_context_update</code> for subsequent stages. * It provides a summary of its operation. To use this custom stage, you would add its configuration to the <code>pipeline_stages</code> list in <code>config/settings.yaml</code>: <div class="highlight"><pre><code><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a># config/settings.yaml (snippet) <a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a>asr_got: <a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a> # ... other asr_got settings ... <a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a> pipeline_stages: <a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a> # ... other stages ... <a id="__codelineno-3-6" name="__codelineno-3-6" href="#__codelineno-3-6"></a> - name: "Custom Claude Query" <a id="__codelineno-3-7" name="__codelineno-3-7" href="#__codelineno-3-7"></a> module_path: "src.adaptive_graph_of_thoughts.domain.stages.custom_claude_stage.ClaudeQueryStage" <a id="__codelineno-3-8" name="__codelineno-3-8" href="#__codelineno-3-8"></a> enabled: true <a id="__codelineno-3-9" name="__codelineno-3-9" href="#__codelineno-3-9"></a> # ... other stages ... </code></pre></div> <h2 id="disclaimer">Disclaimer</h2> Integrating direct LLM calls like those to the Claude API is an advanced extension point. Developers should carefully consider: <ul> <li>API Costs: Frequent or large-scale calls to Claude can incur significant costs. Monitor usage and optimize prompts/requests.</li> <li>Rate Limits: Be aware of Claude API rate limits and implement appropriate backoff and retry strategies (potentially more robust than the basic example).</li> <li>Latency: Direct API calls, especially synchronous ones, can add latency to the ASR-GoT pipeline. Consider asynchronous patterns or background tasks for non-critical API calls if they might block pipeline progression.</li> <li>Error Handling: Implement comprehensive error handling for API unavailability, timeouts, invalid responses, etc.</li> <li>Data Privacy and Security: Ensure that data sent to external APIs complies with privacy policies and security requirements.</li> </ul> By understanding these considerations, developers can effectively extend Adaptive Graph of Thoughts's capabilities using the Claude API. ``` </article> </div> <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> <button type="button" class="md-top md-icon" data-md-component="top" hidden> <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8z"/></svg> Back to top </button> </main> <footer class="md-footer"> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class="md-copyright"> Made with <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener"> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class="md-dialog" data-md-component="dialog"> <div class="md-dialog__inner md-typeset"></div> </div> <script id="__config" type="application/json">{"base": "..", "features": ["navigation.tabs", "navigation.sections", "toc.integrate", "navigation.top", "search.suggest", "search.highlight", "content.tabs.link", "content.code.annotation", "content.code.copy", "navigation.indexes", "navigation.expand", "header.autohide"], "search": "../assets/javascripts/workers/search.d50fe291.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script> <script src="../assets/javascripts/bundle.13a4f30d.min.js"></script> <script src="https://unpkg.com/mermaid@10.4.0/dist/mermaid.min.js"></script> </body> </html>

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/SaptaDey/Adaptive-Graph-of-Thoughts-MCP-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server