Gauntlet-Incept MCP

docs
# Gauntlet Incept MCP Server

This document explains how to set up and use the Gauntlet Incept Model Context Protocol (MCP) server with Claude Desktop.

## What is the Model Context Protocol?

The Model Context Protocol (MCP) is an open standard released by Anthropic that enables secure, two-way connections between AI assistants like Claude and external data sources or tools. This allows Claude to interact with the Gauntlet Incept system to generate, tag, and grade educational content.

## Setting Up Claude Desktop with Gauntlet Incept

### Prerequisites

1. Claude Desktop application installed on your computer
2. Gauntlet Incept repository cloned to your local machine
3. Node.js and npm installed
4. Access to the RDS PostgreSQL database (credentials provided by administrator)
5. SSH key for database connection (if connecting through SSH tunnel)

### Configuration Steps

1. **Start the MCP Server**

   You can start the MCP server using Docker Compose:

   ```bash
   docker-compose up mcp-server
   ```

   Or directly with npm:

   ```bash
   npm run mcp
   ```

2. **Configure Claude Desktop**

   Create or edit the Claude Desktop configuration file:

   - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
   - **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

   Add the following configuration:

   ```json
   {
     "mcpServers": {
       "gauntlet-incept": {
         "command": "node",
         "args": [
           "path/to/gauntlet-incept/src/mcp-server.js"
         ],
         "env": {
           "PORT": "3001",
           "DB_HOST": "alphacommoncrawl-core-reboot.cluster-caeuiwckzo1a.us-east-1.rds.amazonaws.com",
           "DB_PORT": "5432",
           "DB_NAME": "core",
           "DB_USER": "postgres",
           "DB_PASSWORD": "your_database_password"
         }
       }
     }
   }
   ```

   Replace `path/to/gauntlet-incept` with the actual path to your Gauntlet Incept repository.
   Replace `your_database_password` with the actual database password provided by your administrator.

   **Note**: If you need to connect through an SSH tunnel, you'll need to set up the tunnel separately before starting the MCP server.

3. **Restart Claude Desktop**

   Close and reopen Claude Desktop to apply the configuration changes.

## Using Gauntlet Incept with Claude

Once configured, Claude Desktop will have access to the following tools:

### Question Tools

- **tagQuestion**: Tag a question with subject, grade, standard, lesson, and difficulty
- **gradeQuestion**: Grade a tagged question against quality standards
- **generateQuestion**: Generate a question based on tags or an example question

### Article Tools

- **tagArticle**: Tag an article with subject, grade, standard, and lesson
- **gradeArticle**: Grade a tagged article against quality standards
- **generateArticle**: Generate an article based on tags or an example article

### Database Tools

- **searchExamples**: Search for example content in the CCC database
- **getCourseStructure**: Get the structure of a course

### Example Prompts

Here are some example prompts you can use with Claude Desktop:

1. **Generate a math question for 6th grade**:
   
   "Please generate a 6th grade math question about division of fractions. Use the generateQuestion tool with the appropriate tags."

2. **Tag an educational article**:
   
   "I have an educational article about photosynthesis. Can you tag it with the appropriate subject, grade, standard, and lesson? Here's the article: [paste article content]"

3. **Grade a question for quality**:
   
   "Can you grade this question for quality? [paste question content]. The tags are: subject: math, grade: 6, standard: CCSS.Math.6.NS.1, lesson: Division of Fractions, difficulty: 2"

4. **Search for example content**:
   
   "Can you search for example math questions for 6th grade about division of fractions?"

## Troubleshooting

If you encounter issues with the MCP server:

1. **Check the server logs** for error messages
2. **Verify the database connection** is working properly
   - Ensure you have network access to the RDS instance
   - If using SSH tunnel, verify the tunnel is active
3. **Ensure Claude Desktop is properly configured** with the correct path to the MCP server
4. **Restart both the MCP server and Claude Desktop**

For more detailed information, refer to the [Anthropic MCP Documentation](https://docs.anthropic.com/claude/docs/model-context-protocol). 