@clarified/mcp-server-noir

An MCP (Model Context Protocol) server that provides seamless access to the Noir programming language codebase and documentation. This server enables AI assistants to efficiently search through Noir's source code, standard library, and documentation.

Introduction

The Noir MCP server acts as a bridge between AI assistants and the Noir codebase. It provides tools to search through:

• Noir standard library implementations
• Official documentation
• Noir bignum library

Installation & Setup

GitHub Configuration

The server requires a GitHub personal access token with repo scope to access the Noir repositories. Set this token in your environment:

export GITHUB_TOKEN=your_token_here

Integration with AI Assistants

Claude Desktop App

1. Open the Claude configuration file:

~/Library/Application Support/Claude/claude_desktop_config.json

2. Add the Noir MCP server configuration:

{
  "mcpServers": {
    "noir": {
      "command": "npx -y @clarified/mcp-server-noir",
      "env": {
        "GITHUB_TOKEN": "your_token_here"
      },
      "disabled": false
    }
  }
}

Cline

1. Open the Cline settings file:

~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

2. Add the Noir MCP server configuration:

{
  "mcpServers": {
    "noir": {
      "command": "npx -y @clarified/mcp-server-noir",
      "env": {
        "GITHUB_TOKEN": "your_token_here"
      },
      "disabled": false
    }
  }
}

Features

Available Tool

search_noir

Search for code or documentation across Noir repositories.

{
  name: "search_noir",
  inputSchema: {
    type: "object",
    properties: {
      query: {
        type: "string",
        description: "Search query"
      },
      path: {
        type: "string",
        description: "Optional path to search in (docs, stdlib)"
      },
      fileType: {
        type: "string",
        enum: ["nr", "md"],
        description: "Optional file type filter"
      }
    },
    required: ["query"]
  }
}

Example usage:

// Search for hash function implementations
{
  "name": "search_noir",
  "arguments": {
    "query": "hash function",
    "path": "stdlib",
    "fileType": "nr"
  }
}

// Search documentation about constraints
{
  "name": "search_noir",
  "arguments": {
    "query": "constraint system",
    "fileType": "md"
  }
}

Development

Building from Source

1. Clone the repository
2. Install dependencies:

pnpm install

3. Build the project:

pnpm build

4. Watch mode for development:

pnpm watch

Project Structure

src/
├── config/       # Configuration files
├── tools/        # Tool implementations
├── utils/        # Utility functions
└── index.ts      # Main server entry point

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request