Skip to main content
Glama
Presh-AR

codescan-mcp-server

by Presh-AR

Codescan MCP Server

A Model Context Protocol (MCP) server implementation for Codescan, enabling AI models to interact with Codescan's API through a standardized interface.

Features

  • List Codescan projects

  • Get project metrics

  • Query project issues with advanced filtering

  • Environment-based configuration

  • Docker support

  • TypeScript implementation

Related MCP server: sonarqube-mcp

Prerequisites

  • Node.js 20 or later

  • pnpm 10.7.1 or later

  • Docker (optional, for containerized deployment)

Installation

Local Development

  1. Clone the repository:

git clone <repository-url>
cd codescan-mcp-server
  1. Install dependencies:

pnpm install
  1. Build the project:

pnpm run build
  1. Start the server:

pnpm start

Docker Deployment

  1. Build the Docker image:

docker build -t codescan-mcp-server .
  1. Run the container:

docker run -d \
  -e CODESCAN_URL=https://app.codescan.io \
  -e CODESCAN_TOKEN=your_token_here \
  -e CODESCAN_ORGANIZATION=your_org \
  -e CODESCAN_PROJECT=your_project \
  -e CODESCAN_COMPONENT=your_component \
  -e NODE_OPTIONS="--experimental-specifier-resolution=node" \
  -p 3000:3000 \
  codescan-mcp-server

Environment Variables

Variable

Description

Required

Default

CODESCAN_URL

URL of your Codescan instance

Yes

https://app.codescan.io

CODESCAN_TOKEN

Authentication token for Codescan API

Yes

-

CODESCAN_ORGANIZATION

Organization key for Codescan Cloud

No

-

CODESCAN_PROJECT

Default project key

No

-

CODESCAN_COMPONENT

Default component key

No

-

NODE_OPTIONS

Node.js runtime options

No

--experimental-specifier-resolution=node

MCP Client Configuration

Here's an example MCP client configuration for interacting with the Codescan MCP server:

{
  "name": "codescan-mcp-client",
  "version": "1.0.0",
  "description": "MCP client for Codescan integration",
  "servers": [
    {
      "name": "codescan-mcp-server",
      "url": "http://localhost:3000",
      "tools": ["projects", "metrics", "issues"]
    }
  ],
  "env": {
    "CODESCAN_URL": "https://app.codescan.io",
    "CODESCAN_TOKEN": "your_token_here",
    "CODESCAN_ORGANIZATION": "your_org",
    "CODESCAN_PROJECT": "your_project",
    "CODESCAN_COMPONENT": "your_component"
  }
}

Tool Usage Examples

  1. List Projects:

{
  "tool": "projects",
  "params": {
    "page": "1",
    "page_size": "10"
  }
}
  1. Get Metrics:

{
  "tool": "metrics",
  "params": {
    "component": "your_component",
    "page": "1",
    "page_size": "10"
  }
}
  1. Get Issues:

{
  "tool": "issues",
  "params": {
    "component": "your_component",
    "severity": "MAJOR",
    "page": "1",
    "page_size": "10",
    "statuses": ["OPEN", "CONFIRMED"],
    "types": ["BUG", "VULNERABILITY"]
  }
}

Development

Available Scripts

  • pnpm run build: Build the TypeScript code

  • pnpm start: Start the MCP server

  • pnpm test: Run tests

  • pnpm lint: Run linter

  • pnpm format: Format code

Project Structure

codescan-mcp-server/
├── src/
│   ├── index.ts        # Main server entry point
│   └── codescan.ts     # Codescan API client
├── dist/               # Compiled JavaScript
├── Dockerfile          # Docker configuration
├── package.json        # Project dependencies
├── tsconfig.json       # TypeScript configuration
└── mcp.json           # MCP server configuration

License

[License Type] - See LICENSE file for details

Install Server
A
license - permissive license
C
quality
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • F
    license
    A
    quality
    D
    maintenance
    A read-only MCP server that provides AI assistants with structured access to SonarQube projects, issues, metrics, and rules. It enables safe analysis of code quality and security findings through a set of validated, safety-first tools.
    Last updated
    6
  • A
    license
    A
    quality
    C
    maintenance
    An MCP server for SonarQube that enables LLM agents to discover projects, analyze code quality metrics, check Quality Gate status, search issues with filters, and rank projects by worst-performing metrics. It provides read-only, safe access to SonarQube instances with structured outputs and error handling.
    Last updated
    5
    MIT
  • A
    license
    C
    quality
    B
    maintenance
    A Python MCP server for SonarQube, enabling AI agents to query projects, issues, quality gates, coverage, and security hotspots.
    Last updated
    13
    MIT

View all related MCP servers

Related MCP Connectors

  • MCP server providing access to the Scorecard API to evaluate and optimize LLM systems.

  • MCP server for AI access to SmartBear tools, including BugSnag, Reflect, Swagger, PactFlow, QTM4J.

  • MCP server for Pentest-Tools.com: run scans, manage findings and reports via your preffered LLM.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Presh-AR/codescan-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server