MCP 服务器

Code Explainer MCP

一个 Cloudflare Worker，用于分析源代码，并提供全面的解释，包括架构图、核心功能分析以及跨多种编程语言的组件分解。

README

代码解释器 MCP

一个 Cloudflare Worker，用作代码解释的 MCP（模型上下文协议）服务器。它分析并解释代码，并提供结构和功能的全面分解。

特性

架构图: 生成一个 ASCII 图，显示整体结构、组件之间的关系和数据流。
核心功能分析: 基于模式识别，识别并解释代码的主要目的。
组件分解: 列出所有主要类和函数，并简要描述它们的作用。
多语言支持: 分析各种编程语言的代码，包括 JavaScript、TypeScript、Python、Java、C# 等。
JSDoc/Docstring 识别: 提取并利用代码中现有的文档。
安全 API: 使用 Bearer token 身份验证来保护您的端点。

工作原理

代码解释器使用以下技术的组合来分析源代码：

模式识别: 识别代码结构和常见模式
关系分析: 映射组件之间的依赖关系
文档提取: 优先考虑现有的文档注释
架构可视化: 创建代码结构的 ASCII 图
组件描述: 提供函数和类的语义描述

所有处理都在 Cloudflare Worker 中进行，没有外部依赖项。

安装

前提条件

Node.js（12 或更高版本）
Wrangler (Cloudflare Workers CLI)
一个 Cloudflare 帐户

设置

克隆此存储库：

git clone https://github.com/BillDuke13/code-explainer-mcp.git
cd code-explainer-mcp

安装依赖项：
```
npm install
```
配置您的密钥：
- 编辑 wrangler.jsonc 并将 YOUR_SECRET_KEY_HERE 替换为您选择的密钥，或者
- 使用 Cloudflare secrets（推荐用于生产环境）：
```
wrangler secret put SHARED_SECRET
```
部署到 Cloudflare Workers：
```
npm run deploy
```

用法

API 端点

向您的 worker URL 发送一个 POST 请求，包含以下 JSON body：

{
  "method": "explainCode",
  "params": ["your code here", "programming language"]
}

在 Authorization header 中包含您的密钥：

Authorization: Bearer YOUR_SECRET_KEY_HERE

响应格式

响应将是一个 JSON 对象，其中包含一个 result 字段，其中包含代码分析：

{
  "result": "# JavaScript 代码的代码分析\n\n## 架构图\n...\n\n## 核心功能\n..."
}

使用示例

JavaScript (浏览器)

async function explainCode(code, language) {
  const response = await fetch('https://your-worker-url.workers.dev', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer YOUR_SECRET_KEY_HERE',
    },
    body: JSON.stringify({
      method: "explainCode",
      params: [code, language]
    }),
  });
  
  if (!response.ok) {
    throw new Error(`HTTP error! status: ${response.status}`);
  }
  
  const data = await response.json();
  return data.result;
}

// Example usage
const jsCode = `function add(a, b) { return a + b; }`;
explainCode(jsCode, "javascript")
  .then(explanation => console.log(explanation))
  .catch(error => console.error('Error:', error));

Python (Requests)

import requests
import json

def explain_code(code, language, api_url, secret_key):
    headers = {
        'Content-Type': 'application/json',
        'Authorization': f'Bearer {secret_key}'
    }
    
    payload = {
        'method': 'explainCode',
        'params': [code, language]
    }
    
    response = requests.post(api_url, headers=headers, json=payload)
    response.raise_for_status()
    
    return response.json()['result']

# Example usage
code = "def hello(): print('Hello, world!')"
explanation = explain_code(code, "python", "https://your-worker-url.workers.dev", "YOUR_SECRET_KEY_HERE")
print(explanation)

Node.js (Axios)

const axios = require('axios');

async function explainCode(code, language) {
  try {
    const response = await axios.post('https://your-worker-url.workers.dev', {
      method: 'explainCode',
      params: [code, language]
    }, {
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer YOUR_SECRET_KEY_HERE'
      }
    });
    
    return response.data.result;
  } catch (error) {
    console.error('Error:', error.response ? error.response.data : error.message);
    throw error;
  }
}

// Example usage
const codeToAnalyze = `
class Person {
  constructor(name) {
    this.name = name;
  }
  
  sayHello() {
    return \`Hello, my name is \${this.name}\`;
  }
}
`;

explainCode(codeToAnalyze, 'javascript')
  .then(explanation => console.log(explanation))
  .catch(err => console.error('Failed to explain code:', err));

本地开发

克隆存储库并安装依赖项：

git clone https://github.com/BillDuke13/code-explainer-mcp.git
cd code-explainer-mcp
npm install

运行开发服务器：
```
wrangler dev
```

在本地测试端点：

curl -X POST http://localhost:8787 \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_SECRET_KEY_HERE" \
  -d '{"method":"explainCode","params":["function hello() { return \"Hello World\"; }","javascript"]}'