[{"data":1,"prerenderedAt":459},["ShallowReactive",2],{"infra-\u002Finfra\u002Fservices\u002Fmcp-soubiran-dev":3,"infra-children-\u002Finfra\u002Fservices\u002Fmcp-soubiran-dev":458},{"id":4,"title":5,"body":6,"contentId":380,"description":381,"ecosystem":382,"extension":448,"meta":449,"navigation":450,"part":451,"path":452,"rawbody":453,"repository":24,"robots":451,"schemaOrg":451,"seo":454,"sitemap":455,"stem":456,"url":15,"__hash__":457},"pages\u002Finfra\u002Fservices\u002Fmcp-soubiran-dev.md","mcp.soubiran.dev",{"type":7,"value":8,"toc":369},"minimark",[9,19,38,43,65,72,80,83,87,93,104,107,118,122,128,131,135,141,144,310,316,320,325,345,348,352,355,358,362,365],[10,11,12,18],"p",{},[13,14,5],"a",{"href":15,"rel":16},"https:\u002F\u002Fmcp.soubiran.dev\u002Fmcp",[17],"nofollow"," gives assistants access to my public English and French content. It exposes three read-only tools for topic discovery, complete Markdown retrieval, and exact metadata queries.",[10,20,21,22,27,28,32,33,37],{},"The ",[13,23,26],{"href":24,"rel":25},"https:\u002F\u002Fgithub.com\u002Fbarbapapazes\u002Fmcp.soubiran.dev",[17],"TypeScript Worker"," uses the Model Context Protocol SDK and the Cloudflare Agents MCP handler. Requests to ",[29,30,31],"code",{},"\u002Fmcp"," reach the server. Other paths redirect to ",[13,34,36],{"href":35},"\u002Finfra\u002Fwebsites\u002Fsoubiran-dev","soubiran.dev",". The handler does not require authentication.",[39,40,42],"h2",{"id":41},"one-content-catalog-two-locales","One content catalog, two locales",[10,44,45,46,49,50,53,54,49,57,60,61,64],{},"The server loads the website's ",[29,47,48],{},"\u002Fpages.en.json"," and ",[29,51,52],{},"\u002Fpages.fr.json"," feeds in parallel. ",[29,55,56],{},"PAGES_EN_URL",[29,58,59],{},"PAGES_FR_URL"," configure their locations. Zod validates the records, and the loader combines them into one ",[29,62,63],{},"pages"," array.",[10,66,67,68,71],{},"Each record has a stable ID, locale, content type, title, published URL, and ",[29,69,70],{},"markdownUrl",". Descriptions, dates, and translation links are optional. Relative URLs are resolved against the feed URL. Duplicate IDs across the combined feeds cause an error rather than selecting one document arbitrarily.",[10,73,74,75,79],{},"The website catalog covers pages, posts, talks, series, series articles, and infrastructure documentation. ",[13,76,78],{"href":77},"\u002Finfra\u002Fwebsites\u002Ftalks-soubiran-dev","talks.soubiran.dev"," supplies talk content to the website during its build. The MCP reads the resulting website documents through the same catalog as the rest of the content.",[10,81,82],{},"Publication stays with the website. The MCP fetches metadata and follows the supplied Markdown URLs; it does not maintain another document store.",[39,84,86],{"id":85},"search-retrieve-or-query","Search, retrieve, or query",[88,89,91],"h3",{"id":90},"search_content",[29,92,90],{},[10,94,95,96,99,100,103],{},"This tool accepts a natural-language query and searches the ",[29,97,98],{},"soubiran-dev"," Cloudflare AI Search instance. Search and catalog loading run in parallel. Retrieval requests up to 20 results with a match threshold of 0.6 and reranks them with ",[29,101,102],{},"@cf\u002Fbaai\u002Fbge-reranker-base",".",[10,105,106],{},"The server matches each search chunk's metadata ID to a catalog record. It returns the score, excerpt, source key, and page metadata, including the published URL for citations. Chunks without a matching catalog entry are omitted.",[10,108,109,110,113,114,117],{},"Search finds relevant content, but ranking does not establish which page is newest. Exact date comparisons belong in ",[29,111,112],{},"list_pages",", and an assistant should read the full document with ",[29,115,116],{},"get_page"," before summarizing it.",[88,119,120],{"id":116},[29,121,116],{},[10,123,124,125,127],{},"This tool accepts an exact stable ID, resolves it in the combined catalog, and fetches its ",[29,126,70],{},". It returns the complete document as text. An unknown ID or failed upstream request produces an MCP tool error.",[10,129,130],{},"A talk document can include its summary, event details, resource links, and transcript. The website composes that Markdown, so retrieval works the same way for a talk, post, or infrastructure page.",[88,132,133],{"id":112},[29,134,112],{},[10,136,137,138,140],{},"This tool accepts a single asynchronous JavaScript arrow function. The function can read the combined ",[29,139,63],{}," array to filter by locale or type, match titles, compare dates, count records, or group metadata. It does not search document bodies.",[10,142,143],{},"For example, this query returns the five most recent dated English posts with the fields needed for retrieval and citation:",[145,146,151],"pre",{"className":147,"code":148,"language":149,"meta":150,"style":150},"language-js shiki shiki-themes github-light github-light github-dark","async () => pages\n  .filter(page => page.locale === 'en' && page.type === 'post' && page.date)\n  .sort((a, b) => b.date.localeCompare(a.date))\n  .slice(0, 5)\n  .map(({ id, title, date, url }) => ({ id, title, date, url }))\n","js","",[29,152,153,172,218,251,273],{"__ignoreMap":150},[154,155,158,162,166,169],"span",{"class":156,"line":157},"line",1,[154,159,161],{"class":160},"s8jYJ","async",[154,163,165],{"class":164},"sxrX7"," () ",[154,167,168],{"class":160},"=>",[154,170,171],{"class":164}," pages\n",[154,173,175,178,182,185,189,192,195,198,202,205,208,210,213,215],{"class":156,"line":174},2,[154,176,177],{"class":164},"  .",[154,179,181],{"class":180},"snPdu","filter",[154,183,184],{"class":164},"(",[154,186,188],{"class":187},"sP4rz","page",[154,190,191],{"class":160}," =>",[154,193,194],{"class":164}," page.locale ",[154,196,197],{"class":160},"===",[154,199,201],{"class":200},"sIIMD"," 'en'",[154,203,204],{"class":160}," &&",[154,206,207],{"class":164}," page.type ",[154,209,197],{"class":160},[154,211,212],{"class":200}," 'post'",[154,214,204],{"class":160},[154,216,217],{"class":164}," page.date)\n",[154,219,221,223,226,229,231,234,237,240,242,245,248],{"class":156,"line":220},3,[154,222,177],{"class":164},[154,224,225],{"class":180},"sort",[154,227,228],{"class":164},"((",[154,230,13],{"class":187},[154,232,233],{"class":164},", ",[154,235,236],{"class":187},"b",[154,238,239],{"class":164},") ",[154,241,168],{"class":160},[154,243,244],{"class":164}," b.date.",[154,246,247],{"class":180},"localeCompare",[154,249,250],{"class":164},"(a.date))\n",[154,252,254,256,259,261,265,267,270],{"class":156,"line":253},4,[154,255,177],{"class":164},[154,257,258],{"class":180},"slice",[154,260,184],{"class":164},[154,262,264],{"class":263},"sBjJW","0",[154,266,233],{"class":164},[154,268,269],{"class":263},"5",[154,271,272],{"class":164},")\n",[154,274,276,278,281,284,287,289,292,294,297,299,302,305,307],{"class":156,"line":275},5,[154,277,177],{"class":164},[154,279,280],{"class":180},"map",[154,282,283],{"class":164},"(({ ",[154,285,286],{"class":187},"id",[154,288,233],{"class":164},[154,290,291],{"class":187},"title",[154,293,233],{"class":164},[154,295,296],{"class":187},"date",[154,298,233],{"class":164},[154,300,301],{"class":187},"url",[154,303,304],{"class":164}," }) ",[154,306,168],{"class":160},[154,308,309],{"class":164}," ({ id, title, date, url }))\n",[10,311,312,313,315],{},"Returning only the relevant records and fields reduces how much metadata enters the model's context. Both discovery tools return IDs that ",[29,314,116],{}," can resolve.",[39,317,319],{"id":318},"isolated-code-execution","Isolated code execution",[10,321,322,324],{},[29,323,112],{}," uses Code Mode to answer metadata questions without a separate tool for every filter or aggregation. Acorn parses the submitted code and checks that it is one asynchronous arrow function. Input is limited to 20,000 characters.",[10,326,327,328,330,331,334,335,233,338,341,342,103],{},"Worker Loader runs the function in a temporary Worker with a recursively frozen copy of ",[29,329,63],{},". The Worker has no secrets, storage, or application bindings. Network access is disabled with ",[29,332,333],{},"globalOutbound: null",", and the executor also disables ",[29,336,337],{},"fetch",[29,339,340],{},"WebSocket",", and ",[29,343,344],{},"EventSource",[10,346,347],{},"Execution has a 50 ms CPU limit and permits no subrequests. The function must return a JSON-serializable value, and the server rejects results larger than 256 KiB. Query failures become tool errors rather than failing the MCP request handler.",[39,349,351],{"id":350},"deployment-and-observability","Deployment and observability",[10,353,354],{},"Wrangler deploys the server to Cloudflare Workers with an AI Search namespace binding and a Worker Loader binding. The MCP handler uses a configurable allowed CORS origin.",[10,356,357],{},"Cloudflare persists logs and traces. Sentry captures exceptions, with user information and HTTP body collection disabled. Evlog records request duration, tool outcomes, selected upstream timings, result counts, and response sizes. Submitted query code is not logged. Redaction rules cover input and output payloads, queries, document content, excerpts, Markdown, authorization headers, and cookies.",[39,359,361],{"id":360},"ecosystem","Ecosystem",[363,364],"infra-ecosystem",{},[366,367,368],"style",{},"html pre.shiki code .s8jYJ, html code.shiki .s8jYJ{--shiki-light:#D73A49;--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sxrX7, html code.shiki .sxrX7{--shiki-light:#24292E;--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .snPdu, html code.shiki .snPdu{--shiki-light:#6F42C1;--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sP4rz, html code.shiki .sP4rz{--shiki-light:#E36209;--shiki-default:#E36209;--shiki-dark:#FFAB70}html pre.shiki code .sIIMD, html code.shiki .sIIMD{--shiki-light:#032F62;--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .sBjJW, html code.shiki .sBjJW{--shiki-light:#005CC5;--shiki-default:#005CC5;--shiki-dark:#79B8FF}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":150,"searchDepth":174,"depth":174,"links":370},[371,372,377,378,379],{"id":41,"depth":174,"text":42},{"id":85,"depth":174,"text":86,"children":373},[374,375,376],{"id":90,"depth":220,"text":90},{"id":116,"depth":220,"text":116},{"id":112,"depth":220,"text":112},{"id":318,"depth":174,"text":319},{"id":350,"depth":174,"text":351},{"id":360,"depth":174,"text":361},"cf208554-4904-4184-8ddb-05a8201c4347","My MCP server searches English and French website content, retrieves complete Markdown pages, and runs isolated JavaScript queries against page metadata.",[383,428,437,443],{"type":384,"id":385,"name":386,"description":387,"ecosystem":388},"deployment","mcp-soubiran-dev","Cloudflare Workers","Expose the MCP server at `\u002Fmcp` and redirect other paths to the personal website.",[389,394,416,422],{"type":390,"id":385,"name":391,"description":392,"href":393},"build","Wrangler","Deploy the TypeScript Worker with Wrangler.","https:\u002F\u002Fdevelopers.cloudflare.com\u002Fworkers\u002Fwrangler\u002F",{"type":395,"id":5,"name":396,"description":397,"href":24,"ecosystem":398},"repository","GitHub","Host the Worker source, content tools, and deployment configuration.",[399,404,408,412],{"type":400,"name":401,"description":402,"href":403},"stack","Model Context Protocol SDK","Define the server, tool inputs, and protocol responses.","https:\u002F\u002Fmodelcontextprotocol.io",{"type":400,"name":405,"description":406,"href":407},"Cloudflare Agents","Handle MCP requests at the Worker's `\u002Fmcp` endpoint.","https:\u002F\u002Fdevelopers.cloudflare.com\u002Fagents\u002F",{"type":400,"name":409,"description":410,"href":411},"Zod","Validate localized page catalogs and tool inputs.","https:\u002F\u002Fzod.dev",{"type":400,"name":413,"description":414,"href":415},"Acorn","Parse query code and require a single asynchronous arrow function.","https:\u002F\u002Fgithub.com\u002Facornjs\u002Facorn",{"type":417,"id":418,"name":419,"description":420,"href":421},"data","soubiran-dev-ai-search","Cloudflare AI Search","Search the `soubiran-dev` instance through the `AI_SEARCH` namespace binding.","https:\u002F\u002Fdevelopers.cloudflare.com\u002Fai-search\u002F",{"type":423,"id":424,"name":425,"description":426,"href":427},"runtime","mcp-content-loader","Cloudflare Worker Loader","Execute metadata queries in temporary Workers with network access disabled.","https:\u002F\u002Fdevelopers.cloudflare.com\u002Fworkers\u002Fruntime-apis\u002Fworker-loader\u002F",{"type":417,"id":429,"name":430,"description":431,"ecosystem":432},"localized-website-catalogs","Localized page catalogs and Markdown","Load `pages.en.json` and `pages.fr.json`, then retrieve documents through each record's `markdownUrl`.",[433],{"type":434,"name":36,"relationship":435,"description":436},"website","producer","Publish pages, posts, series, talks, and infrastructure documentation in a shared content catalog.",{"type":438,"id":439,"name":440,"description":441,"href":442},"monitoring","mcp-sentry","Sentry","Capture request and tool exceptions without collecting user information or HTTP bodies.","https:\u002F\u002Fsentry.io",{"type":438,"id":444,"name":445,"description":446,"href":447},"mcp-evlog","Evlog","Record structured request and tool outcomes with sensitive content redacted.","https:\u002F\u002Fevlog.dev","md",{},true,null,"\u002Finfra\u002Fservices\u002Fmcp-soubiran-dev","---\ncontentId: cf208554-4904-4184-8ddb-05a8201c4347\ntitle: mcp.soubiran.dev\ndescription: >-\n  My MCP server searches English and French website content, retrieves complete\n  Markdown pages, and runs isolated JavaScript queries against page metadata.\nurl: 'https:\u002F\u002Fmcp.soubiran.dev\u002Fmcp'\nrepository: 'https:\u002F\u002Fgithub.com\u002Fbarbapapazes\u002Fmcp.soubiran.dev'\necosystem:\n  - type: deployment\n    id: mcp-soubiran-dev\n    name: Cloudflare Workers\n    description: Expose the MCP server at `\u002Fmcp` and redirect other paths to the personal website.\n    ecosystem:\n      - type: build\n        id: mcp-soubiran-dev\n        name: Wrangler\n        description: Deploy the TypeScript Worker with Wrangler.\n        href: 'https:\u002F\u002Fdevelopers.cloudflare.com\u002Fworkers\u002Fwrangler\u002F'\n      - type: repository\n        id: mcp.soubiran.dev\n        name: GitHub\n        description: Host the Worker source, content tools, and deployment configuration.\n        href: 'https:\u002F\u002Fgithub.com\u002Fbarbapapazes\u002Fmcp.soubiran.dev'\n        ecosystem:\n          - type: stack\n            name: Model Context Protocol SDK\n            description: Define the server, tool inputs, and protocol responses.\n            href: 'https:\u002F\u002Fmodelcontextprotocol.io'\n          - type: stack\n            name: Cloudflare Agents\n            description: Handle MCP requests at the Worker's `\u002Fmcp` endpoint.\n            href: 'https:\u002F\u002Fdevelopers.cloudflare.com\u002Fagents\u002F'\n          - type: stack\n            name: Zod\n            description: Validate localized page catalogs and tool inputs.\n            href: 'https:\u002F\u002Fzod.dev'\n          - type: stack\n            name: Acorn\n            description: Parse query code and require a single asynchronous arrow function.\n            href: 'https:\u002F\u002Fgithub.com\u002Facornjs\u002Facorn'\n      - type: data\n        id: soubiran-dev-ai-search\n        name: Cloudflare AI Search\n        description: Search the `soubiran-dev` instance through the `AI_SEARCH` namespace binding.\n        href: 'https:\u002F\u002Fdevelopers.cloudflare.com\u002Fai-search\u002F'\n      - type: runtime\n        id: mcp-content-loader\n        name: Cloudflare Worker Loader\n        description: Execute metadata queries in temporary Workers with network access disabled.\n        href: 'https:\u002F\u002Fdevelopers.cloudflare.com\u002Fworkers\u002Fruntime-apis\u002Fworker-loader\u002F'\n  - type: data\n    id: localized-website-catalogs\n    name: Localized page catalogs and Markdown\n    description: Load `pages.en.json` and `pages.fr.json`, then retrieve documents through each record's `markdownUrl`.\n    ecosystem:\n      - type: website\n        name: soubiran.dev\n        relationship: producer\n        description: Publish pages, posts, series, talks, and infrastructure documentation in a shared content catalog.\n  - type: monitoring\n    id: mcp-sentry\n    name: Sentry\n    description: Capture request and tool exceptions without collecting user information or HTTP bodies.\n    href: 'https:\u002F\u002Fsentry.io'\n  - type: monitoring\n    id: mcp-evlog\n    name: Evlog\n    description: Record structured request and tool outcomes with sensitive content redacted.\n    href: 'https:\u002F\u002Fevlog.dev'\n---\n\n[mcp.soubiran.dev](https:\u002F\u002Fmcp.soubiran.dev\u002Fmcp) gives assistants access to my public English and French content. It exposes three read-only tools for topic discovery, complete Markdown retrieval, and exact metadata queries.\n\nThe [TypeScript Worker](https:\u002F\u002Fgithub.com\u002Fbarbapapazes\u002Fmcp.soubiran.dev) uses the Model Context Protocol SDK and the Cloudflare Agents MCP handler. Requests to `\u002Fmcp` reach the server. Other paths redirect to [soubiran.dev](\u002Finfra\u002Fwebsites\u002Fsoubiran-dev). The handler does not require authentication.\n\n## One content catalog, two locales\n\nThe server loads the website's `\u002Fpages.en.json` and `\u002Fpages.fr.json` feeds in parallel. `PAGES_EN_URL` and `PAGES_FR_URL` configure their locations. Zod validates the records, and the loader combines them into one `pages` array.\n\nEach record has a stable ID, locale, content type, title, published URL, and `markdownUrl`. Descriptions, dates, and translation links are optional. Relative URLs are resolved against the feed URL. Duplicate IDs across the combined feeds cause an error rather than selecting one document arbitrarily.\n\nThe website catalog covers pages, posts, talks, series, series articles, and infrastructure documentation. [talks.soubiran.dev](\u002Finfra\u002Fwebsites\u002Ftalks-soubiran-dev) supplies talk content to the website during its build. The MCP reads the resulting website documents through the same catalog as the rest of the content.\n\nPublication stays with the website. The MCP fetches metadata and follows the supplied Markdown URLs; it does not maintain another document store.\n\n## Search, retrieve, or query\n\n### `search_content`\n\nThis tool accepts a natural-language query and searches the `soubiran-dev` Cloudflare AI Search instance. Search and catalog loading run in parallel. Retrieval requests up to 20 results with a match threshold of 0.6 and reranks them with `@cf\u002Fbaai\u002Fbge-reranker-base`.\n\nThe server matches each search chunk's metadata ID to a catalog record. It returns the score, excerpt, source key, and page metadata, including the published URL for citations. Chunks without a matching catalog entry are omitted.\n\nSearch finds relevant content, but ranking does not establish which page is newest. Exact date comparisons belong in `list_pages`, and an assistant should read the full document with `get_page` before summarizing it.\n\n### `get_page`\n\nThis tool accepts an exact stable ID, resolves it in the combined catalog, and fetches its `markdownUrl`. It returns the complete document as text. An unknown ID or failed upstream request produces an MCP tool error.\n\nA talk document can include its summary, event details, resource links, and transcript. The website composes that Markdown, so retrieval works the same way for a talk, post, or infrastructure page.\n\n### `list_pages`\n\nThis tool accepts a single asynchronous JavaScript arrow function. The function can read the combined `pages` array to filter by locale or type, match titles, compare dates, count records, or group metadata. It does not search document bodies.\n\nFor example, this query returns the five most recent dated English posts with the fields needed for retrieval and citation:\n\n```js\nasync () => pages\n  .filter(page => page.locale === 'en' && page.type === 'post' && page.date)\n  .sort((a, b) => b.date.localeCompare(a.date))\n  .slice(0, 5)\n  .map(({ id, title, date, url }) => ({ id, title, date, url }))\n```\n\nReturning only the relevant records and fields reduces how much metadata enters the model's context. Both discovery tools return IDs that `get_page` can resolve.\n\n## Isolated code execution\n\n`list_pages` uses Code Mode to answer metadata questions without a separate tool for every filter or aggregation. Acorn parses the submitted code and checks that it is one asynchronous arrow function. Input is limited to 20,000 characters.\n\nWorker Loader runs the function in a temporary Worker with a recursively frozen copy of `pages`. The Worker has no secrets, storage, or application bindings. Network access is disabled with `globalOutbound: null`, and the executor also disables `fetch`, `WebSocket`, and `EventSource`.\n\nExecution has a 50 ms CPU limit and permits no subrequests. The function must return a JSON-serializable value, and the server rejects results larger than 256 KiB. Query failures become tool errors rather than failing the MCP request handler.\n\n## Deployment and observability\n\nWrangler deploys the server to Cloudflare Workers with an AI Search namespace binding and a Worker Loader binding. The MCP handler uses a configurable allowed CORS origin.\n\nCloudflare persists logs and traces. Sentry captures exceptions, with user information and HTTP body collection disabled. Evlog records request duration, tool outcomes, selected upstream timings, result counts, and response sizes. Submitted query code is not logged. Redaction rules cover input and output payloads, queries, document content, excerpts, Markdown, authorization headers, and cookies.\n\n## Ecosystem\n\n::infra-ecosystem\n::\n",{"title":5,"description":381},{"loc":452},"infra\u002Fservices\u002Fmcp-soubiran-dev","J1HgAzkigYvVb7k-sqa2CTdzeO4bcUiTSlYJMi4h7hI",[],1795016673336]