mcp

This MCP server enables LunarCrush AI capabilities via a local stdio Node.js implementation. The server runs index.js under Node.js and expects your LunarCrush API key to be provided through the LUNARCRUSH_API_KEY environment variable. The README also documents remote HTTP/SSE endpoints you can use for integration, but this configuration focuses on the stdio workflow where the MCP server process is started locally and communicates with LunarCrush using your API key. To use it, set the LUNARCRUSH_API_KEY environment variable with your key, ensure Node.js is installed, and run the mapped server entry (index.js) through the MCP framework with the provided path. You can then feed requests to the MCP server, and it will proxy or translate them into LunarCrush API calls as defined by the underlying implementation.

The available capabilities include LunarCrush authentication via API key and access to the LunarCrush AI & MCP capabilities referenced in the LunarCrush developer docs. The README also shows remote configurations (Streamable HTTP and SSE) that rely on a Bearer token header; if you prefer those, you would configure an HTTP-type MCP server pointing at the provided URLs with your API key in the Authorization header. For the stdio setup, use the Node.js entry point and supply the key locally.

Prerequisites:

• Node.js (recommended LTS version) installed on your machine
• Internet access to fetch dependencies if using a package.json setup

Installation steps:

1. Prepare environment variables and paths
   • Create or choose a project directory where index.js resides (the LunarCrush stdio MCP Server entry point).
   • Ensure you have your LunarCrush API key ready.
2. Install dependencies (if a package.json is provided in the project)
   • Open a terminal in the project root and run: npm install
3. Configure the MCP entry
   • Ensure index.js is accessible at the path you reference in mcp_config (e.g., <absolute_path_to_project_root>/index.js).
   • Create or update the environment configuration to include: LUNARCRUSH_API_KEY=<your_lunarcrush_api_key>
4. Start the MCP server via your MCP runner using the provided mcp_config definition (node index.js) or your standard startup command.
5. Verify connectivity
   • Check logs for successful startup messages.
   • Use your MCP client to send requests to the LunarCrush MCP endpoint and ensure responses are returned as expected.

Environment variables and configuration:

• Use LUNARCRUSH_API_KEY to authenticate with LunarCrush when using the stdio MCP server.
• If you opt for the remote HTTP/SSE configuration, you must provide the Authorization header with a Bearer token containing your LunarCrush API key in the mcpServers.http configuration.
• Replace <absolute_path_to_project_root> with the actual filesystem path to the project root where index.js resides. Common issues:
• Node.js not installed or not in PATH: install Node.js and re-run.
• Missing API key: ensure LUNARCRUSH_API_KEY is set in the environment or provided in your runner configuration.
• Incorrect path to index.js: verify the path exists and is readable by the MCP process.