systemprompt

systemprompt-mcp-server is a production-ready MCP server that demonstrates the complete MCP specification, including OAuth 2.1, sampling, elicitation, structured data validation, and real-time notifications using Reddit as a real-world API example. It is compatible with the MCP Inspector and provides a suite of Reddit interaction tools along with prompts, resource management, and multi-user session support. To run quickly with minimal setup, you can use npx to fetch and start the server directly, then connect your MCP client to http://localhost:3000 to begin the OAuth flow and explore the available tools for Reddit interactions such as content discovery, user interactions, subreddit information, and comment thread analysis. The server also supports real-time progress notifications and AI-assisted content generation through its structured prompt and sampling features.

Prerequisites:

• Node.js and npm (or use Docker as an alternative).
• Optional: Git if you want to clone the repository.

Install options:

1. Quick start with npx (no installation):

   • Ensure you have npm available.
   • Run: npx -y @systemprompt/systemprompt-mcp-server
   • This will start the MCP server directly.

2. Install globally via npm (for repeated use):

   • npm install -g @systemprompt/systemprompt-mcp-server
   • Start the server (if the package exposes a CLI entry):
     • systemprompt-mcp-server or npx @systemprompt/systemprompt-mcp-server

3. Clone and install from source (for development):

   • git clone https://github.com/systempromptio/systemprompt-mcp-server.git
   • cd systemprompt-mcp-server
   • npm install
   • npm run build (if a build step exists in the project)

Configuration (required):

• Create a Reddit app at reddit.com/prefs/apps (script type) and set the redirect URI to http://localhost:3000/oauth/reddit/callback
• Create a .env file with required credentials, e.g.: REDDIT_CLIENT_ID=your_reddit_client_id REDDIT_CLIENT_SECRET=your_reddit_client_secret JWT_SECRET=your_jwt_secret PORT=3000 OAUTH_ISSUER=http://localhost:3000 REDIRECT_URL=http://localhost:3000/oauth/reddit/callback REDDIT_USER_AGENT=linux:systemprompt-mcp-reddit:v2.0.0 LOG_LEVEL=info

Tips and common considerations:

• The MCP server demonstrates OAuth 2.1 with PKCE, JWT tokens, and session management. Keep JWT_SECRET and client credentials secure.
• When using Docker, you can bind environment variables via a .env file or --env-file; ensure the Reddit app credentials are kept out of public repos.
• If the MCP Inspector is used, you can run npm run inspector to verify compatibility and available tools.
• For production deployments, consider container orchestration, persistent storage for sessions, and secure handling of OAuth tokens.
• If you encounter connectivity issues with Reddit APIs, check REDDIT_USER_AGENT and ensure API keys are valid. Adjust PORT as needed and expose the correct port in your network policy.