youmind-mcp

# YouMind MCP Server A Model Context Protocol (MCP) server built with FastMCP that provides access to YouMind content. ## Features - Retrieve craft content by craft ID - Authenticated API access to YouMind - Simple FastMCP-based implementation ## Prerequisites - Python 3.8 or higher - A YouMind account with valid authentication token ## Installation ### From PyPI (Recommended) ```bash pip install youmind-mcp ``` ### From Source 1. Clone this repository: ```bash git clone <repository-url> cd youmind-mcp ``` 2. Install the package: ```bash pip install . ``` Or install in development mode: ```bash pip install -e . ``` ### Configuration Set up environment variables. You can either: 1. Create a `.env` file: ```bash cp .env.example .env ``` 2. Edit `.env` and add your YouMind authentication token: ``` YOUMIND_AUTH_TOKEN=sb-flzdupptcpbcowdaetfq-auth-token=your-actual-token-here ``` Or set the environment variable directly: ```bash export YOUMIND_AUTH_TOKEN=sb-flzdupptcpbcowdaetfq-auth-token=your-actual-token-here ``` **To get your authentication token:** 1. Log in to YouMind in your browser 2. Open browser developer tools (F12) 3. Go to Application/Storage > Cookies > https://youmind.com 4. Copy the value of `sb-flzdupptcpbcowdaetfq-auth-token` 5. Set `YOUMIND_AUTH_TOKEN=sb-flzdupptcpbcowdaetfq-auth-token=<copied-value>` ## Usage ### Running the Server After installation, you can run the MCP server using: ```bash youmind-mcp ``` Or as a Python module: ```bash python -m youmind_mcp ``` The server will start and communicate via stdio (standard input/output), which is the standard transport for MCP servers. ### Using with MCP Clients Configure your MCP client (e.g., Claude Desktop, Cursor) to use this server: **After pip installation:** ```json { "mcpServers": { "youmind": { "command": "youmind-mcp", "env": { "YOUMIND_AUTH_TOKEN": "sb-flzdupptcpbcowdaetfq-auth-token=your-token" } } } } ``` **Or using Python mo…