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（推荐-无需安装）
这是最简单的方法。无需全局安装。
- 获取API密钥 来自Codesona仪表板
- 配置IDE （请参阅下面的IDE特定说明）
方法2：全球安装
全局安装软件包以实现全系统访问：
npm install -g @codesona/mcp-server安装后，使用配置IDE codesona-mcp-server 命令。
方法3：来源
- 克隆存储库
git clone https://dev.azure.com/Azteron/Codesona/_git/CodesonaMCPServer
cd CodesonaMCPServer- 安装依赖项
npm install- 使其可执行 （仅限Unix/Mac）
chmod +x index.js- 配置IDE 使用完整路径
index.js
配置
环境变量
CODESONA_API_KEY（必需）：您的工作区API键来自Codesona仪表板CODESONA_API_URL（可选）：Codesona API URL（默认值：https:/codesona.ai)NODE_ENV（可选）：环境模式（开发/生产）
IDE设置说明
光标
- 打开光标设置
- 雨衣： Cmd + , 或 Code > Settings - Windows/Linux： Ctrl + , 或 File > Preferences > Settings
- 查找MCP设置
- 在设置搜索栏中搜索“MCP” - 或导航到：扩展>MCP
- 编辑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"
}
}
}
}- 更换API键
- 改变 your-workspace-api-key-here 从Codesona仪表板到您的实际API密钥
- 保存并重新启动游标
- 保存文件(Cmd+S / Ctrl+S) - 完全重新启动Cursor （不仅仅是重新加载窗口）
帆板运动
- 打开风帆设置
- 导航到“设置”
- 查找MCP配置
- 查找MCP服务器设置 - 点击“配置MCP服务器”
- 添加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"
}
}
}
}- 更换API键 并保存
- 重新启动Windsurf
克劳德桌面
- 打开Claude桌面配置
- 雨衣： ~/Library/Application Support/Claude/claude_desktop_config.json - 窗户： %APPDATA%\Claude\claude_desktop_config.json
- 添加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"
}
}
}
}- 更换API键 并保存
- 重新启动克劳德桌面
可用的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日志以了解详细的错误消息
发展
地方发展设置
- 安装依赖项
npm install- 设置环境变量
export CODESONA_API_KEY=your-api-key-here
export CODESONA_API_URL=https://codesona.ai
export NODE_ENV=development- 运行服务器
node index.js许可证
麻省理工学院
支持
对于问题或疑问：
- 访问 Codesona文件
- 在此存储库中打开问题