Skip to content

Latest commit

 

History

History

README.md

Agents Microsite

This is the microsite for the Agents project, showcasing features, usage examples etc.

Built with Astro and deployed to Cloudflare Workers.

Getting Started

First, install dependencies:

npm install #run this in the root of the repo

Then run the development server:

npm start

Open http://localhost:4321 with your browser to see the result.

Cloudflare Deployment

The site is built with Astro and deployed to Cloudflare Workers:

# Build the site
npm run build

# Deploy to Cloudflare
npm run deploy

Tech Stack

  • Astro - Modern web framework
  • React - For interactive components with partial hydration
  • Tailwind CSS - Utility-first CSS framework
  • Framer Motion - Animation library
  • GSAP - Advanced animations
  • Cloudflare Workers - Deployment platform

Agents MCP Server

Add to Cursor Add to VS Code

This is an MCP server for anyone building with Agents SDK. It exposes just 1 tool.

{
  "name": "search-agent-docs",
  "description": "Token efficient search of the Cloudflare Agents SDK documentation",
  "inputSchema": {
    "query": {
      "type": "string",
      "description": "query string to search for eg. 'agent hibernate', 'schedule tasks'"
    },
    "k": {
      "type": "number",
      "optional": true,
      "default": 5,
      "description": "number of results to return"
    }
  }
}

Usage

Connect to this MCP server to any MCP Client that supports remote MCP servers.

https://agents.cloudflare.com/mcp

How it works

It pulls the docs from Github, chunks them with a recursive chunker, and indexes them with Orama. The index is cached in KV for 1 day. Search is BM25 with stemming enabled for better results. This allows "hibernation" to match with "hibernate" allowing for more natural language queries.

Ratelimiting

To avoid ratelimiting by GitHub, you can set the GITHUB_TOKEN environment variable with wrangler secret put GITHUB_TOKEN

Development

To run this server locally, you can use the following command:

npm install
npm run dev

You can test this server with the MCP Inspector.

npx @modelcontextprotocol/inspector

Deployment

To deploy this server to Cloudflare Workers, you can use the following command:

npm run deploy