使用说明
MCP服务器集合
一系列的习俗 模型上下文协议(MCP) 服务器和客户端技能,旨在与Claude Desktop(和其他兼容MCP的客户端)集成。这些服务器为AI助手提供了对企业工具的直接访问:Azure DevOps/TFS、Jira(本地和云)、enterprise Architect和AWS(Bedrock+EC2)。
仓库结构
mcp-servers/
├── azure-devops-tfs/ # MCP server for Azure DevOps / TFS on-premises
│ └── server.js
├── jira-onprem/ # MCP server for Jira Server / Data Center (API v2)
│ └── server.js
├── jira-cloud/ # MCP server for Jira Cloud (API v3)
│ └── server.js
├── ea-mcp-server/ # MCP server for Enterprise Architect (MS SQL)
│ ├── server.ts
│ ├── package.json
│ ├── tsconfig.json
│ └── README.md
├── aws/ # MCP server for AWS (Bedrock + EC2)
│ └── server.js
├── skills/ # Client skills (AI instructions for MCP servers)
│ ├── Azure-MCP-client-skill.md
│ ├── Jira-Mcp-client-skill.md
│ ├── EA-DB-based-client-skill.md
│ ├── AWS-MCP-client-skill.md
│ └── Documentation-Reader-skill.md
└── docs/ # Guides and requirements
├── MCP_SETUP_GUIDE_WINDOWS.md # Windows setup guide (EN)
├── MCP_SETUP_GUIDE_WINDOWS.sk.md # Windows setup guide (SK)
└── mcp-ea-requirements.txt # EA server requirements (SK)
MCP服务器
1.Azure DevOps/TFS服务器
用于Azure DevOps服务器(TFS)的轻量级Node.js MCP服务器。零依赖。
工具:
| 工具 | 说明 |
|---|---|
tfs_get_work_item |
获取包含完整详细信息(包括评论)的工作项 |
tfs_get_comments |
获取工作项的评论/历史记录 |
tfs_search_work_items |
使用WIQL查询搜索工作项(支持 top/skip 分页) |
环境变量:
TFS_URL-TFS集合URL(例如。http://tfs.example.local:8080/tfs/your_collection)TFS_PROJECT-项目名称TFS_PAT-个人访问令牌TFS_API_VERSION-API版本(默认:6.0)
2.Jira本地服务器
Jira服务器/数据中心的MCP服务器,使用REST API v2。零依赖。
工具:
| 工具 | 说明 |
|---|---|
jira_search |
使用JQL搜索问题(支持 startAt/maxResults 分页) |
jira_get_issue |
获取完整的问题详细信息 |
jira_create_issue |
创建新问题 |
jira_update_issue |
更新问题字段 |
jira_add_comment |
添加评论 |
jira_get_transitions |
获取可用的工作流转换 |
jira_transition |
将问题转换为新状态 |
jira_link_issues |
将两个问题联系在一起 |
jira_add_worklog |
记录问题的时间 |
jira_get_attachments |
列出附件 |
环境变量:
JIRA_URL-Jira实例URLJIRA_API_TOKEN(或JIRA_PAT)-个人访问令牌JIRA_USERNAME-(可选)用于基本身份验证
3.Jira云服务器
Jira Cloud的MCP服务器,使用REST API v3,支持Atlassian文档格式(ADF)。
与Jira On Premise相同的工具,此外:
| 工具 | 说明 |
|---|---|
jira_search_projects |
搜索项目 |
jira_get_project_issue_types |
获取项目的可用问题类型 |
环境变量: 与Jira On Premise相同。
4.企业架构师服务器
TypeScript MCP服务器,直接从Enterprise Architect的MS SQL数据库读取UML模型。非常适合提取规范、用例场景和图表可视化。
工具:
| 工具 | 说明 |
|---|---|
search_ea_elements |
按名称搜索用例、活动、需求(支持 maxResults/offset 分页) |
get_element_details |
获取包含场景步骤的完整规范(XML) |
search_diagrams |
按名称搜索图表(支持 maxResults/offset 分页) |
get_diagram_as_mermaid |
生成Mermaid.js图表可视化 |
get_element_relationships |
获取可追溯性、层次结构和依赖关系 |
环境变量:
DB_SERVER-MS SQL Server主机名/IPDB_NAME-数据库名称DB_USER-数据库用户名DB_PASSWORD-数据库密码EA_PROJECT_NAME-(可选)将搜索限制到特定的EA项目
设置:
cd ea-mcp-server
npm install
npm run build
5.AWS服务器(基岩+EC2)
适用于AWS的零依赖Node.js MCP服务器。实现 AWS签名V4 本地使用内置 crypto 模块——不需要AWS SDK。通过以下方式支持临时凭据 AWS_SESSION_TOKEN.
工具——基岩:
| 工具 | 说明 |
|---|---|
bedrock_list_foundation_models |
列出基础模型(按提供者、模态、推理类型过滤) |
bedrock_get_foundation_model |
获取单个模型的详细信息 |
bedrock_list_inference_profiles |
列出推理配置文件(例如跨区域路由) |
bedrock_invoke_model |
使用特定于提供者的JSON正文调用模型 |
bedrock_converse |
通过Converse API提供诊断聊天(推荐) |
工具——EC2:
| 工具 | 说明 |
|---|---|
ec2_describe_instances |
列出EC2实例(过滤器、分页、每个调用区域覆盖) |
ec2_describe_regions |
列出AWS区域 |
ec2_describe_security_groups |
列出安全组 |
ec2_describe_vpcs |
列出VPC |
ec2_describe_images |
列出AMI(始终通过 owners 以确定结果范围) |
ec2_start_instances |
启动一个或多个已停止的实例 |
ec2_stop_instances |
停止一个或多个实例(支持 force) |
ec2_reboot_instances |
重新启动一个或多个实例 |
环境变量:
AWS_ACCESS_KEY_ID-访问密钥AWS_SECRET_ACCESS_KEY-秘密访问密钥AWS_SESSION_TOKEN-(可选)临时会话令牌(SSO/STS)AWS_REGION-默认区域(默认值:us-east-1)
通过AWS SSO(IAM身份中心)进行身份验证
对于使用与Microsoft Entra ID(Azure AD)联合的AWS IAM身份中心的组织,请执行 不 使用长期访问密钥——为每个会话颁发临时凭据。同样的流程适用于任何身份中心设置;只有起始URL和IdP不同。
1.一次性AWS CLI v2设置 (安装指南):
aws configure sso
回答提示:
| 提示 | 值 |
|---|---|
| SSO启动URL | https://<your-org>.awsapps.com/start/#/ (您的身份中心门户URL) |
| SSO区域 | 托管身份中心的区域(例如。 eu-central-1) |
| CLI默认客户端区域 | 您主要工作的区域 |
| CLI默认输出格式 | json |
| 个人资料名称 | 您喜欢的任何名称,例如。 my-sso |
浏览器打开——使用您的Microsoft Entra ID/AAzure AD帐户登录,批准设备,然后选择AWS帐户+角色。
2.每日登录 (刷新SSO会话,通常为8-12小时):
aws sso login --profile my-sso
3.将SSO凭据连接到MCP服务器。 服务器读取env变量,而不是 ~/.aws/credentials.两种选择:
选项A——凭证导出包装器(推荐,macOS/Linux):
{
"mcpServers": {
"aws": {
"command": "sh",
"args": [
"-c",
"eval \"$(aws configure export-credentials --profile my-sso --format env-no-export)\" && exec node /absolute/path/to/aws/server.js"
],
"env": {
"AWS_REGION": "eu-central-1"
}
}
}
}
每次Claude Desktop启动服务器时,包装器都会刷新 AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY,以及 AWS_SESSION_TOKEN 从SSO缓存中,然后执行 node只要 aws sso login 仍然有效,重新启动只是工作。
选项B——导出一次,粘贴到配置中:
aws configure export-credentials --profile my-sso --format env-no-export
将三个打印值复制到 env 块。每当SSO会话到期时重复此操作。
Windows(PowerShell包装器): 使用 aws configure export-credentials --profile my-sso --format powershell | Invoke-Expression 前面的 node 使用选项A从WSL调用或运行服务器。
客户技能
这 skills/ 文件夹包含 .md 技能文件可以添加到Claude Desktop或Claude Code中作为项目说明,教AI如何有效地使用这些MCP服务器:
- 技能/Azure-MCP-client-skill.md -Azure DevOps/TFS工作项管理和WIQL查询指南
- 技能/Jira-Mcp-client-skill.md -Jira集成工作流程的综合指南(搜索、创建、链接、测试场景)
- 技能/基于EA-DB的客户端技能.md -EA模型导航、规范提取和图表可视化指南
- 技能/AWS-MCP-client-skill.md -Bedrock调用(Converse API)和EC2车队检查/生命周期操作指南
- 技能/文档-leader-skill.md -分析用户指南和转录记录以提取结构化测试场景的方法
快速开始
先决条件
配置(克劳德桌面)
编辑您的Claude Desktop配置文件:
- 窗户:
%APPDATA%\Claude\claude_desktop_config.json - macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
所有服务器的配置示例:
{
"mcpServers": {
"tfs": {
"command": "node",
"args": ["<path-to>/azure-devops-tfs/server.js"],
"env": {
"TFS_URL": "http://your-tfs-server:8080/tfs/collection",
"TFS_PROJECT": "YourProject",
"TFS_PAT": "YOUR_PAT_TOKEN"
}
},
"jira": {
"command": "node",
"args": ["<path-to>/jira-onprem/server.js"],
"env": {
"JIRA_URL": "https://jira.example.com",
"JIRA_API_TOKEN": "YOUR_JIRA_TOKEN"
}
},
"ea-reader": {
"command": "node",
"args": ["<path-to>/ea-mcp-server/dist/server.js"],
"env": {
"DB_SERVER": "your-sql-server",
"DB_NAME": "your-database",
"DB_USER": "your-user",
"DB_PASSWORD": "YOUR_PASSWORD"
}
},
"aws": {
"command": "node",
"args": ["<path-to>/aws/server.js"],
"env": {
"AWS_ACCESS_KEY_ID": "YOUR_ACCESS_KEY",
"AWS_SECRET_ACCESS_KEY": "YOUR_SECRET_KEY",
"AWS_REGION": "eu-central-1"
}
}
}
}
验证
重启Claude Desktop后,测试每台服务器:
- TFS: “在TFS中显示我的工作项”
- 吉拉: “显示我分配的Jira门票”
- EA: “在EA中搜索登录用例”
- AWS: “在eu-central-1中列出我的EC2实例”或“从Anthropic中列出基岩基础模型”
安全说明
这些MCP服务器设计为本地运行(STDIO)。然而,它们连接到内部服务和数据库。请遵循以下安全最佳实践:
- 令牌范围:使用生成个人访问令牌(PAT) 最低要求特权.
- Azure DevOps:
Work Items (Read & Write),Code (Read),Build (Read). - Jira:使用
Read权限,除非您需要创建/更新问题。 - 亚马逊云服务:仅使用您需要的操作创建IAM用户/角色(例如。
ec2:Describe*,bedrock:InvokeModel,bedrock:ListFoundationModels).避免使用通配符。通过以下方式首选临时凭据AWS_SESSION_TOKEN(SSO/STS)通过长期访问密钥。
- Azure DevOps:
- 超文本传输安全协议:TFS和Jira连接始终使用HTTPS(
https://tfs.example.com).避免HTTP(http://)以防止凭证泄漏。 - 数据库安全性:
- 如果可能,为EA MCP服务器使用只读数据库用户(
db_datareader). - 启用SSL/TLS加密(
encrypt: true)如果您的SQL Server支持,请在您的数据库配置中。 - 对于内部自签名证书,在使用之前,请确保CA是可信的或了解风险
trustServerCertificate: true.
- 如果可能,为EA MCP服务器使用只读数据库用户(
- 日志记录:服务器将错误记录到
stderr。如果MCP客户端日志包含敏感查询数据,请确保其安全存储。
许可证
国际协调委员会
