mcpField
M
MCP Connector

MCP Connector

Local
github.com/JohanKoppenaalDeveloper Tools0Updated 78w ago
Repository

About MCP Connector

MCP Connector runs and manages multiple MCP servers for TypingMind, locally or on a remote server. Its authenticated REST API lets clients start and control servers and inspect or call their tools.

Key features

  1. 01Run multiple MCP servers
  2. 02Local or remote deployment
  3. 03Authenticated REST API
  4. 04List clients and tools
  5. 05Start, restart, and stop clients
  6. 06Call client tools

Use cases

  1. 01Connect MCP servers to TypingMind
  2. 02Manage MCP servers on a remote host
  3. 03Inspect tools available from running clients
  4. 04Invoke a client's tool through the API

MCP support

MCP Connector starts and manages MCP servers and their clients, exposing their tools through an authenticated REST API. It connects to TypingMind using the server address and authentication token.

#mcp-connector#server-management#api-integration

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "n8n-mcp-server-johankoppenaal": {
      "command": "npx",
      "args": [
        "-y",
        "@typingmind/mcp"
      ]
    }
  }
}
Run commandnpx -y @typingmind/mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@typingmind/mcp

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

MCP Connector

MCP Connector is a lightweight server that can run and manage multiple Model Context Protocol (MCP) servers, specifically designed to integrate with TypingMind. It provides an easy way to run MCP servers on your local computer or a remote server, making it possible to connect your custom AI models or tools with TypingMind through a simple REST API.

How to Run on Your Local Device

You can quickly start the MCP Connector using npx (no install required):

npx @typingmind/mcp <auth-token>
  • Replace <auth-token> with your authentication token provided by TypingMind.

Keep this terminal window open while you use TypingMind.

HTTPS Support

To enable HTTPS, set the following environment variables:

CERTFILE=./path/to/certificate.crt KEYFILE=./path/to/privatekey.key npx @typingmind/mcp <auth-token>
  • CERTFILE: Path to your SSL certificate file
  • KEYFILE: Path to your SSL private key file

When both variables are set, the server will use HTTPS instead of HTTP.

How to Run on a Server

If you prefer running the MCP Connector on a remote server:

  1. Install Node.js (version 14 or later).

  2. Run the server using npx:

    npx @typingmind/mcp <auth-token>

    To run with HTTPS:

    CERTFILE=./path/to/certificate.crt KEYFILE=./path/to/privatekey.key npx @typingmind/mcp <auth-token>

    Alternatively, for persistent running (e.g., after closing SSH), you may use a process manager like pm2 or screen/tmux:

    pm2 start npx -- @typingmind/mcp <auth-token>

How to Connect to TypingMind

To connect MCP Connector to TypingMind:

  1. Follow the instructions at www.typingmind.com/mcp.
  2. Paste your MCP Connector server address (http://localhost:<port> or your server’s IP address and port) and your authentication token on the TypingMind MCP integration page.

REST API Endpoints

All API endpoints require authentication via the Bearer token you provide when starting the server.

EndpointMethodDescription
/pingGETHealth check; returns { status: "ok" }
/startPOSTStart one or more MCP clients; body: { mcpServers: { ... } }
/restart/:idPOSTRestart a specific client
/clientsGETList all running MCP clients and their tools
/clients/:idGETGet info about a specific client
/clients/:id/toolsGETList available tools for a client
/clients/:id/call_toolsPOSTCall a tool for a client; body: { name, arguments }
/clients/:idDELETEStop and delete a client

Notes:

  • All requests need an Authorization: Bearer <auth-token> header.
  • Available ports: The server will choose port 50880 or 50881, make sure these ports are available in your system. You can also use PORT environment variable to specify a different port.

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.