Spacefrontiers_mcp

You can run a Space Frontiers MCP server to let language models access Space Frontiers data sources through defined tools. This server exposes searching capabilities across multiple sources and can be used with MCP clients via a remote HTTP endpoint or through STDIO-based communication with a local process.

How to use

Once the MCP server is running, you can call the available tools from your MCP client to search Space Frontiers data. Use the HTTP endpoint for remote interactions or connect via STDIO to run the server locally inside your tooling environment. The two primary tools you have are simple_search for keyword-based queries and search for semantic queries across sources like library, telegram, and reddit. Use these tools to retrieve relevant results that you can feed back into your model prompts.

How to install

Prerequisites you need before installing and running the server

Install Python and a Python runtime that supports FastAPI and the FastMCP library

Install uv (the command-line entry point used to run MCP servers)

Obtain an API key from Space Frontiers and prepare an environment with the key set or ready to pass in headers

Set the required environment variable for API access

Additional sections

Configuration and runtime details are provided below to help you get started and secure access to Space Frontiers data.

uv run mcp run main.py

Example client configuration

If you want to use the Claude Desktop app or a similar client, you can configure the MCP server with a CLI-like setup. The following JSON shows how you would wire the Space Frontiers MCP server into a client config. Replace placeholder paths and the API key with your actual values.

{
  "mcpServers": {
    "Space Frontiers MCP server": {
      "command": "/path/to/your/uv",
      "args": [
        "run",
        "--with",
        "izihawa-loglib",
        "--with",
        "mcp[cli]",
        "--with",
        "spacefrontiers-clients",
        "mcp",
        "run",
        "/path/to/your/spacefrontiers-mcp/mcp_server.py"
      ],
      "env": {
        "SPACE_FRONTIERS_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Available tools

simple_search

Performs a keyword search over specified Space Frontiers databases (library, telegram, or reddit) with parameters for source, query, limit, and offset, returning a string of search results.

search

Performs a semantic search over specified Space Frontiers databases with a query, optional sources, filters, and limit, returning a string of search results.