MCP Template

v1.0.0Developer Toolsstable

A production-ready Python template for building MCP servers with enterprise features including registry integration, configuration management, structured logging, and extensible patterns for tools, resources, and prompts.

claudecursormcpswift
Share:
16
Stars
0
Downloads
0
Weekly
0/5

What is MCP Template?

MCP Template is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to production-ready python template for building mcp servers with enterprise features including registry integration, configuration management, structured logging, and extensible patterns for tools, reso...

A production-ready Python template for building MCP servers with enterprise features including registry integration, configuration management, structured logging, and extensible patterns for tools, resources, and prompts.

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A production-ready Python template for building MCP servers

Use Cases

Build production-ready MCP servers with enterprise patterns.
Integrate with MCP registries and manage server configuration.
Extend with tools, resources, and prompts using structured logging.
masseater

Maintainer

LicenseMIT
Languageswift
Versionv1.0.0
UpdatedMay 20, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx mcp-template

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use MCP Template

This Scrapbox MCP server connects AI assistants to the Scrapbox knowledge-base platform, enabling them to read and write pages in your Scrapbox project. It supports listing pages, retrieving page content, performing full-text search, following outgoing and incoming links, creating new pages, updating existing content, inserting lines at specific positions, and optionally deleting pages. This is especially useful for teams using Scrapbox as a shared wiki who want an AI assistant to help author, search, and organize knowledge.

Prerequisites

  • Bun runtime installed (https://bun.sh) for the recommended install method
  • A Scrapbox account and an existing project at scrapbox.io
  • Your Scrapbox project name (the slug in the URL: scrapbox.io/<project-name>)
  • Your connect.sid session cookie from scrapbox.io (for authentication)
  • An MCP client such as Claude Desktop or Cursor
1

Obtain your Scrapbox session cookie

Log into scrapbox.io in your browser, open DevTools (F12), go to Application > Cookies, and copy the value of the 'connect.sid' cookie. This is required for the MCP server to authenticate API requests on your behalf.

2

Identify your Scrapbox project name

Your project name is the slug that appears in your Scrapbox URLs: https://scrapbox.io/<project-name>/<page-title>. Note this value — you will set it as SCRAPBOX_PROJECT.

3

Add the server to your MCP client configuration

Edit your MCP client's config file (e.g., claude_desktop_config.json) to add the scrapbox-mcp server, providing your project name and cookie.

{
  "mcpServers": {
    "scrapbox-mcp": {
      "command": "bunx",
      "args": ["@r_masseater/scrapbox-mcp@latest"],
      "env": {
        "SCRAPBOX_PROJECT": "your-project-name",
        "SCRAPBOX_COOKIE": "your-connect.sid-value",
        "SCRAPBOX_PRESET": "full"
      }
    }
  }
}
4

Choose a tool preset

Set SCRAPBOX_PRESET to control which tools are available: 'minimal' (list + get only), 'readonly' (list, get, search, links), or 'full' (all tools including write operations). To enable page deletion, also set SCRAPBOX_ENABLE_DELETE=true.

5

Restart your MCP client and verify

Save the configuration and restart your MCP client. You should now be able to list pages, search for content, and create or update pages in your Scrapbox project through natural language prompts.

MCP Template Examples

Client configuration

Full Claude Desktop configuration for the Scrapbox MCP server with full tool access enabled.

{
  "mcpServers": {
    "scrapbox-mcp": {
      "command": "bunx",
      "args": ["@r_masseater/scrapbox-mcp@latest"],
      "env": {
        "SCRAPBOX_PROJECT": "my-team-wiki",
        "SCRAPBOX_COOKIE": "s%3Axxxxxxxxxxxxxxxx...",
        "SCRAPBOX_PRESET": "full",
        "SCRAPBOX_ENABLE_DELETE": "false"
      }
    }
  }
}

Prompts to try

Example prompts for searching, reading, and writing in your Scrapbox wiki.

- "Search my Scrapbox project for pages about 'API design' and summarize the key points."
- "Show me the content of the Scrapbox page titled 'Meeting Notes 2024-01-15'."
- "Create a new Scrapbox page called 'GraphQL Best Practices' with sections for schema design, query optimization, and security."
- "Update the 'Team Glossary' page in Scrapbox by adding a definition for 'MCP' at the end."

Troubleshooting MCP Template

Authentication fails with 401 errors from the Scrapbox API

Your connect.sid cookie may have expired. Log back into scrapbox.io, copy the fresh cookie value from DevTools, and update the SCRAPBOX_COOKIE environment variable in your MCP config.

Pages are not found despite existing in the project

Verify that SCRAPBOX_PROJECT is set to exactly the project slug as it appears in the URL (case-sensitive). Also check that the cookie belongs to an account that has read access to that project.

Write operations (create/update) are not available

Ensure SCRAPBOX_PRESET is set to 'full' (not 'minimal' or 'readonly'). If using SCRAPBOX_TOOLS for custom selection, confirm the write tool names are included in the comma-separated list.

Frequently Asked Questions about MCP Template

What is MCP Template?

MCP Template is a Model Context Protocol (MCP) server that production-ready python template for building mcp servers with enterprise features including registry integration, configuration management, structured logging, and extensible patterns for tools, resources, and prompts. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install MCP Template?

Follow the installation instructions on the MCP Template GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with MCP Template?

MCP Template works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is MCP Template free to use?

Yes, MCP Template is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "mcp-template": { "command": "npx", "args": ["-y", "mcp-template"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use MCP Template?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides