Barnsworthburning MCP is a server that exposes a single tool called "search" which queries barnsworthburning.net via its API at https://barnsworthburning.net/api/search. After connecting this MCP server to an MCP client (such as Claude for Desktop), you can issue a search command by passing a query string to the search tool, and the server will return results from the Barnsworthburning site. This makes it easy to integrate barnsworthburning.net content into MCP-enabled workflows and chat experiences. The server is intended to be used with any MCP-compatible client that supports the standard Model Context Protocol tool invocation flow.

Available tools:

• search: Performs a search on barnsworthburning.net using the site's API. Parameters: query (string) — the search term to look up on barnsworthburning.net. Use natural language or short keywords to obtain relevant results. Examples include asking for articles, topics, or items related to your query. Once connected, you can ask questions like "Search barnsworthburning.net for 'design'" or "Find articles about typography on barnsworthburning.net".

Prerequisites:

• Node.js (recommended: Node.js v14 or newer) and npm installed on your system.
• Basic familiarity with cloning repositories and running npm commands.

Manual installation steps:

1. Clone the repository: git clone https://github.com/Alias/barnsworthburning-mcp.git cd barnsworthburning-mcp

2. Install dependencies: npm install

3. Build the server: npm run build

4. Run the MCP server: npm run start

   Alternatively, if a start script is not defined, you can run:

   node dist/server.js

Note: If you prefer to install via Smithery, you can run: npx -y @smithery/cli install @Aias/barnsworthburning-mcp --client claude

Ensure the server has network access to barnsworthburning.net and that the API endpoint at https://barnsworthburning.net/api/search is reachable from your hosting environment.

Tips and common considerations:

• The server relies on the external barnsworthburning.net API. If the API changes or has rate limits, you may see degraded results or failures; monitor logs for API errors.
• If you need to customize the endpoint or add headers, you can modify the server code under src and rebuild with npm run build.
• Ensure your hosting environment allows outbound HTTPS requests to barnsworthburning.net. Some corporate networks may block external APIs.
• If you encounter port or binding issues, verify the environment where the MCP server runs and adjust any necessary environment variables or startup flags in the deployment configuration.