MCP ExplorerExplorer

Codex Mcps Demo

@jordan-cutleron 9 months ago
3 MIT
FreeCommunity
AI Systems
A demo project for MCP Server using Claude for diagram generation.

Overview

What is Codex Mcps Demo

codex-mcps-demo is a demonstration project that utilizes the Claude AI model from Anthropic to generate diagrams from code structures. It serves as an example of how to integrate AI capabilities into coding workflows.

Use cases

Use cases include generating documentation for codebases, visualizing code structures for better understanding, and automating the documentation process in continuous integration workflows.

How to use

To use codex-mcps-demo, clone the repository, set up your environment with the required API key and Node.js version, install necessary dependencies, and run the provided scripts to generate diagrams from your code.

Key features

Key features include the ability to generate AI-driven diagrams from code, integration with Anthropic’s Claude AI, and a customizable workflow that can be adapted for automated documentation generation.

Where to use

codex-mcps-demo can be used in software development environments, particularly in projects that require documentation generation, code visualization, or integration of AI tools into development processes.

Content

codex-mcps-demo

Try it out

  1. git clone https://github.com/jordan-cutler/codex-mcps-demo.git to clone the repo.
  2. Create a .env file and set ANTHROPIC_API_KEY to your API key from the Anthropic console.
  3. nvm install 22 && nvm alias default 22 && nvm use 22 to ensure you have node 22 and are using it
  4. npm i -g pnpm to ensure you have pnpm installed
  5. pnpm install to install dependencies
  6. npm install -g @anthropic-ai/claude-code to install Claude per the official docs
  7. node --experimental-strip-types scripts/claudeDiagram.ts <inputFolder>. For example, node --experimental-strip-types scripts/claudeDiagram.ts folder-samples/slack.
  8. You should see the outputs/ folder update as Claude runs. Once it’s finished, it will output a diagram.ai.md file to <inputFolder>/diagram.ai.md. For example, here’s a commit from running it on folder-samples/slack

[!NOTE]
From the .claude/settings.json file, Claude has access to bash commands. Run the script at your own risk.

Future expansion

There is a Github action in .github/workflows/claude-diagram.yml which runs the Claude script on a hardcoded folder (folder-samples/slack). This could be modified to only pass in any folders which have changed from the most recent push. Doing this would auto-generate documentation for every changed folder in the codebase as engineers commit to it.

You may or may not want to do this for your own reasons 😄

Tools

No tools

Comments

Recommend MCP Servers

View All MCP Servers