Codesona MCP Server

Codesona MCP服务器

一个标准的MCP服务器，通过stdio传输提供团队编码标准。该服务器连接到Codesona API，并将您团队的编码规则提供给IDE中的AI助手，如Cursor、Windsurf和其他MCP兼容工具。

特性

• 🔄 从集中式Codesona API自动获取规则
• 📦 智能缓存（5分钟缓存）
• ⚡ 快速轻量级的Node.js实现
• 🔐 安全的API密钥身份验证
• 📊 完全符合MCP协议

安装

先决条件

• Node.js 18.0.0或更高版本
• Codesona工作区API密钥（从 Codesona仪表板)

方法1：使用npx（推荐-无需安装）

这是最简单的方法。无需全局安装。

1. 获取API密钥 来自Codesona仪表板

1. 配置IDE （请参阅下面的IDE特定说明）

方法2：全球安装

全局安装软件包以实现全系统访问：

npm install -g @codesona/mcp-server

安装后，使用配置IDE codesona-mcp-server 命令。

方法3：来源

1. 克隆存储库

git clone https://dev.azure.com/Azteron/Codesona/_git/CodesonaMCPServer
cd CodesonaMCPServer

1. 安装依赖项

npm install

1. 使其可执行 （仅限Unix/Mac）

chmod +x index.js

1. 配置IDE 使用完整路径 index.js

配置

环境变量

• CODESONA_API_KEY （必需）：您的工作区API键来自Codesona仪表板
• CODESONA_API_URL （可选）：Codesona API URL（默认值： https:/codesona.ai)
• NODE_ENV （可选）：环境模式（开发/生产）

IDE设置说明

光标

1. 打开光标设置

- 雨衣： Cmd + , 或 Code > Settings - Windows/Linux： Ctrl + , 或 File > Preferences > Settings

1. 查找MCP设置

- 在设置搜索栏中搜索“MCP” - 或导航到：扩展>MCP

1. 编辑MCP配置

- 点击“在settings.json中编辑” - 添加以下配置：

使用npx（推荐）：

{
  "mcpServers": {
    "codesona": {
      "command": "npx",
      "args": ["-y", "@codesona/mcp-server"],
      "env": {
        "CODESONA_API_KEY": "your-workspace-api-key-here"
      }
    }
  }
}

使用全局安装：

{
  "mcpServers": {
    "codesona": {
      "command": "codesona-mcp-server",
      "env": {
        "CODESONA_API_KEY": "your-workspace-api-key-here"
      }
    }
  }
}

1. 更换API键

- 改变 your-workspace-api-key-here 从Codesona仪表板到您的实际API密钥

1. 保存并重新启动游标

- 保存文件(Cmd+S / Ctrl+S) - 完全重新启动Cursor （不仅仅是重新加载窗口）

帆板运动

1. 打开风帆设置

- 导航到“设置”

1. 查找MCP配置

- 查找MCP服务器设置 - 点击“配置MCP服务器”

1. 添加Codesona服务器

使用npx（推荐）：

{
  "mcpServers": {
    "codesona": {
      "command": "npx",
      "args": ["-y", "@codesona/mcp-server"],
      "env": {
        "CODESONA_API_KEY": "your-workspace-api-key-here"
      }
    }
  }
}

使用全局安装：

{
  "mcpServers": {
    "codesona": {
      "command": "codesona-mcp-server",
      "env": {
        "CODESONA_API_KEY": "your-workspace-api-key-here"
      }
    }
  }
}

1. 更换API键 并保存

1. 重新启动Windsurf

克劳德桌面

1. 打开Claude桌面配置

- 雨衣： ~/Library/Application Support/Claude/claude_desktop_config.json - 窗户： %APPDATA%\Claude\claude_desktop_config.json

1. 添加MCP服务器配置

使用npx（推荐）：

{
  "mcpServers": {
    "codesona": {
      "command": "npx",
      "args": ["-y", "@codesona/mcp-server"],
      "env": {
        "CODESONA_API_KEY": "your-workspace-api-key-here"
      }
    }
  }
}

使用全局安装：

{
  "mcpServers": {
    "codesona": {
      "command": "codesona-mcp-server",
      "env": {
        "CODESONA_API_KEY": "your-workspace-api-key-here"
      }
    }
  }
}

1. 更换API键 并保存

1. 重新启动克劳德桌面

可用的MCP工具

get_coding_rules

检索强制性团队编码标准。接受可选 codeContext 参数：

• language：编程语言（例如“csharp”、“javascript”）
• framework：框架名称（例如“aspnet”、“react”）
• platform：平台类型（例如，“后端”、“前端”）

规则将缓存5分钟。

suggest_new_rule

为团队标准提出新的编码规则。所需参数： title, description, rationale.可选： exampleCode, badExampleCode, goodExampleCode, codeContext.

可用MCP资源

• 团队编码标准 (codesona://standards/team)：适用于所有项目的团队范围规则

可用MCP提示

• apply-coding-standards：通过即时采样将团队编码标准应用于对话

故障排除

服务器无法启动：

• 验证 CODESONA_API_KEY 设置正确
• 检查Node.js版本是否为18.0.0或更高版本
• 确保API密钥有效

无效的API密钥：

• 从Codesona仪表板获取新的API密钥
• 验证密钥是否具有正确的权限

规则未更新：

• 规则缓存5分钟
• 等待缓存到期或检查Codesona API以获取更新

IDE无法连接：

• 验证Node.js是否在PATH中
• 检查环境变量是否设置正确
• 查看IDE日志以了解详细的错误消息

发展

地方发展设置

1. 安装依赖项

npm install

1. 设置环境变量

export CODESONA_API_KEY=your-api-key-here
export CODESONA_API_URL=https://codesona.ai
export NODE_ENV=development

1. 运行服务器

node index.js

许可证

麻省理工学院

支持

对于问题或疑问：

• 访问 Codesona文件
• 在此存储库中打开问题