home / mcp / tripura state board mcp server

Tripura State Board MCP Server

Provides MCP access to Tripura TBSE data sources and actions through a Python stdio-based server.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "ag2-mcp-servers-tripura-state-board-of-secondary-education-tripura": {
      "command": "python",
      "args": [
        "mcp_server/main.py",
        "stdio"
      ],
      "env": {
        "CONFIG": "{\"example_key\":\"example_value\"}",
        "SECURITY": "API_KEY=YOUR_API_KEY",
        "CONFIG_PATH": "path/to/mcp_config.json"
      }
    }
  }
}

You explore an MCP (Model Context Protocol) Server designed to expose a structured API surface for a specific data domain. This enables you to query and interact with context-aware data through MCP clients, providing consistent access patterns, transport options, and programmable endpoints that you can integrate into your applications.

How to use

Use an MCP client to connect to the Tripura State Board of Secondary Education Tripura MCP Server. You can query for contextual information and actions exposed by the server, then incorporate the results into your workflows, dashboards, or automation tasks. Depending on the transport mode you choose, your client will either communicate over a standard input/output channel or over a streaming/HTTP-based path. Start with the standard input/output (stdio) mode for local development and testing, then explore other modes if needed.

How to install

Prerequisites you need to satisfy before installing and running the server are Python 3.9 or newer, plus pip and uv. Follow these concrete steps to install and prepare the MCP server on your machine.

# Step 1: Clone the project repository
git clone <repository-url>
cd mcp-server

# Step 2: Install dependencies (dev environment)
pip install -e ".[dev]"

# Optional alternative using uv for development
uv pip install --editable ".[dev]"

Step 3: Start the MCP server in stdio mode for local development and testing.

python mcp_server/main.py stdio

Step 4: If you need to customize startup via environment variables, you can provide a configuration path or a JSON configuration string. Common options include CONFIG_PATH for a file path and CONFIG for an inline JSON string. You can also set SECURITY-related parameters as needed.

Configuration and security

The server accepts several environment-based configuration options. Use these when starting the server to control behavior without modifying code.

Environment variables you may set include:

- CONFIG_PATH: Path to a JSON configuration file (for example, mcp_server/mcp_config.json).

- CONFIG: A JSON string containing the configuration directly.

- SECURITY: Environment variables that define security parameters such as API keys. Provide these values as needed by your deployment.

Transport modes and client considerations

The MCP server supports multiple transport modes, including stdio, SSE, and streamable-http. Choose the mode that best fits your deployment scenario and client capabilities. For local development, stdio is the simplest option because you launch the server as a local process and communicate via standard input/output.

Notes and troubleshooting

If you encounter startup issues, verify you are using Python 3.9+ and that dependencies are installed correctly. Ensure the command you run to start the server matches the supported transport mode you intend to use. If a configuration path is provided, confirm that the file exists and contains valid JSON. For security-related problems, review your API key or security token handling and ensure the SERVER is reachable with the expected credentials.

Available tools

ruff

Lints and formats code to maintain a clean, consistent style.

pytest

Runs the test suite to validate functionality and catch regressions.

mypy

Performs static type checking to ensure type correctness across the codebase.

pre-commit

Runs code quality checks before commits to catch issues early.