Master MCP Server

import{_ as a,c as i,o as e,a6 as t}from"./chunks/framework.CHl2ywxc.js";const c=JSON.parse('{"title":"Getting Started","description":"","frontmatter":{},"headers":[],"relativePath":"getting-started.md","filePath":"getting-started.md","lastUpdated":1755281500000}'),n={name:"getting-started.md"};function l(p,s,h,o,d,r){return e(),i("div",null,s[0]||(s[0]=[t(`<h1 id="getting-started" tabindex="-1">Getting Started <a class="header-anchor" href="#getting-started" aria-label="Permalink to &quot;Getting Started&quot;">​</a></h1><p>This guide walks you through running Master MCP Server locally, configuring backends, and discovering capabilities.</p><h2 id="prerequisites" tabindex="-1">Prerequisites <a class="header-anchor" href="#prerequisites" aria-label="Permalink to &quot;Prerequisites&quot;">​</a></h2><ul><li>Node.js &gt;= 18.17</li><li>npm</li><li>Network access to install dependencies and reach your OAuth providers/backends</li></ul><h2 id="install" tabindex="-1">Install <a class="header-anchor" href="#install" aria-label="Permalink to &quot;Install&quot;">​</a></h2><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>npm ci</span></span></code></pre></div><h2 id="configure" tabindex="-1">Configure <a class="header-anchor" href="#configure" aria-label="Permalink to &quot;Configure&quot;">​</a></h2><ol><li>Copy env template and edit as needed:</li></ol><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>cp .env.example .env</span></span></code></pre></div><ol start="2"><li>Put your configuration in <code>config/</code> or pass a YAML/JSON path via <code>MASTER_CONFIG_PATH</code>. The built-in schema lives in <code>config/schema.json</code> and is also embedded as a fallback.</li></ol><p>Example minimal YAML (single local server):</p><div class="language-yaml vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">yaml</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">hosting</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">:</span></span> <span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> platform</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">node</span></span> <span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> port</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">3000</span></span> <span class="line"></span> <span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">master_oauth</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">:</span></span> <span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> authorization_endpoint</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">https://example.com/oauth/authorize</span></span> <span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> token_endpoint</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">https://example.com/oauth/token</span></span> <span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> client_id</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">master-mcp</span></span> <span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> redirect_uri</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">http://localhost:3000/oauth/callback</span></span> <span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> scopes</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: [</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">openid</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">]</span></span> <span class="line"></span> <span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">servers</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">:</span></span> <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> - </span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">id</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">tools</span></span> <span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> type</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">local</span></span> <span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> auth_strategy</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">bypass_auth</span></span> <span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> config</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">:</span></span> <span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> port</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">3333</span></span></code></pre></div><h2 id="run-dev-server" tabindex="-1">Run Dev Server <a class="header-anchor" href="#run-dev-server" aria-label="Permalink to &quot;Run Dev Server&quot;">​</a></h2><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>npm run dev</span></span></code></pre></div><p>If your config is outside <code>config/</code>, set:</p><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>MASTER_CONFIG_PATH=examples/sample-configs/basic.yaml npm run dev</span></span></code></pre></div><h2 id="verify" tabindex="-1">Verify <a class="header-anchor" href="#verify" aria-label="Permalink to &quot;Verify&quot;">​</a></h2><ul><li><code>GET http://localhost:3000/health</code> → <code>{ ok: true }</code></li><li><code>POST http://localhost:3000/mcp/tools/list</code></li><li><code>POST http://localhost:3000/mcp/resources/list</code></li></ul><p>When calling tools/resources on protected backends, include <code>Authorization: Bearer &lt;token&gt;</code>.</p><h2 id="next-steps" tabindex="-1">Next Steps <a class="header-anchor" href="#next-steps" aria-label="Permalink to &quot;Next Steps&quot;">​</a></h2><ul><li>Read <code>docs/guides/authentication.md</code> for OAuth flows</li><li>See <code>examples/*</code> to run end-to-end scenarios</li><li>Deploy using <code>docs/deployment/*</code></li></ul>`,21)]))}const g=a(n,[["render",l]]);export{c as __pageData,g as default};