Istek MCP Server

MCP (Model Context Protocol) server for Istek API Client.

This MCP server allows AI assistants like Claude to interact with Istek API Client, enabling them to manage workspaces, collections, environments, variables, and request history.

Prerequisites

• Istek must be running (the internal API runs on port 47835)

• Node.js 18+

Installation

npm install
npm run build

Usage with Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "istek": {
      "command": "node",
      "args": ["/path/to/istek-mcp/dist/index.js"]
    }
  }
}

Available Tools

Workspace Management

• list_workspaces - List all workspaces

• get_workspace - Get a specific workspace

• create_workspace - Create a new workspace

• activate_workspace - Set a workspace as active

Collection Management

• list_collections - List all collections in a workspace

• get_collection - Get a collection with all its requests

• create_collection - Create a new collection

• add_request_to_collection - Add an API request to a collection

Environment Management

• list_environments - List all environments

• get_environment - Get an environment with its variables

• create_environment - Create a new environment

• activate_environment - Set an environment as active

Variable Management

• list_variables - List global variables

• create_variable - Create a new variable

• update_variable - Update an existing variable

History

• list_history - List request history

• get_history_item - Get details of a history item

• clear_history - Clear all history

Utilities

• check_istek_status - Check if Istek API is running

Available Resources

• istek://workspaces - List of all workspaces

• istek://health - API health status

Development

# Watch mode
npm run dev

# Test with MCP Inspector
npm run inspect

Example Usage

Once configured, you can ask Claude things like:

• "List all my Istek workspaces"

• "Create a new collection called 'User API' in my default workspace"

• "Add a GET request to /api/users to the User API collection"

• "Show me the request history for today"

• "Create a new environment called 'Production' with the base URL variable"

License

MIT