ASMR-One MCP Server

ASMR-One MCP Server (Cloudflare Worker)

This project implements an MCP (Model Context Protocol) server for fetching ASMR work information from asmr-one.com, designed to run on Cloudflare Workers.

Features

• Search ASMR: Search for ASMR works by keyword, circle, tag, or voice actor.
• Random ASMR: Get a random ASMR work recommendation.
• Returns links in asmr.one or dlsite format.

Deploy to Cloudflare

You can deploy this worker to your Cloudflare account using several methods:

Method 1: Deploy with Cloudflare Button (Simplest)

This button initiates a guided deployment process. It should automatically detect the project type and settings from wrangler.toml.

Method 2: Manual "Connect to Git" in Cloudflare Dashboard

If you manually set up a "Deploy from Git" connection for this Worker in your Cloudflare dashboard (e.g., via a link like https://dash.cloudflare.com/YOUR_ACCOUNT_ID/workers-and-pages/create/deploy-to-workers?repository=...):

• Project Name: Choose a name (e.g., asmr-one-mcp-worker).
• Production Branch: main.
• Root Directory: / (if wrangler.toml is in the root of your repository).
• Build command (Optional):
  • You can often leave this blank. Cloudflare's build system will use wrangler.toml to deploy.
  • If a command is required, or to ensure all dependencies are explicitly installed in the build environment, use: npm install
• Build output directory (Optional): Leave this blank. This is not typically used for Worker deployments in the same way it is for static sites (Cloudflare Pages).
• Cloudflare will then use wrangler (based on your wrangler.toml) to build and deploy your Worker upon commits to the production branch.

Method 3: Using Wrangler CLI (Manual Deployment)

This method gives you the most control and is useful for local testing and manual deployments.

1. Clone the repository:
   git clone https://github.com/yukikazechan/asmr-one-mcp-worker.git cd asmr-one-mcp-worker
2. Install dependencies:
   npm install
3. Log in to Cloudflare (if you haven't already):
   npx wrangler login
4. Deploy the Worker:
   npm run deploy
   (This script in package.json runs wrangler deploy)

After Deployment: Cloudflare will provide you with a unique URL for your worker (e.g., https://your-worker-name.your-username.workers.dev). You will need this URL to configure it as a remote MCP server.

Configuration

The primary configuration is done via the wrangler.toml file.

Tag Map (Tag Caching)

The server fetches and caches ASMR tags to improve search accuracy for aliased or partial tags. Currently, this cache is in-memory per worker instance.

For more robust and persistent caching in a production environment, consider using Cloudflare KV:

1. Create a KV Namespace in your Cloudflare dashboard.
2. Uncomment and configure the [[kv_namespaces]] section in wrangler.toml:
   [[kv_namespaces]] binding = "ASMR_TAGS_KV" # This binding name is used in src/index.ts id = "your_kv_namespace_id_here" # Get this from your Cloudflare dashboard
3. The code in src/index.ts has commented-out lines for KV integration. You would need to uncomment and potentially adapt the loadTagsIfNeeded function to use env.ASMR_TAGS_KV.
4. Re-deploy your worker after making these changes.

Local Development (using Wrangler CLI)

1. Ensure you have cloned the repository and installed dependencies as shown in "Method 3" above.
2. Start the local development server:
   npm run dev
   This will typically start a server on http://localhost:8787 for testing your Worker locally.

Using as an MCP Server

Once deployed, you can add this worker as a remote MCP server in your MCP client's settings (e.g., mcp_settings.json).

Example configuration:

Make sure the /mcp path in the URL matches how your worker handles requests (currently, the provided src/index.ts expects MCP requests on the root path of the worker, so /mcp might not be needed unless you add routing). If your worker handles MCP requests at the root, the URL would be https://your-worker-name.your-username.workers.dev. The current src/index.ts does not implement a specific /mcp route, it processes POST requests to the worker's root.

Project Structure

• src/index.ts: The main worker code.
• wrangler.toml: Cloudflare Worker configuration file.
• package.json: Project dependencies and scripts.
• tsconfig.json: TypeScript configuration.