This server provides a tool to retrieve detailed information about work items (requirements) by their ID via the MCP protocol.
Retrieve Work Item Details: Fetch structured JSON data containing the plain text description, image URLs, and raw HTML content of a work item by providing its ID (e.g., YEPPPP-154).
Error Handling: Returns standardized error messages if the external API request fails.
Security: Supports secure handling of sensitive information (organization ID and API token) through environment variables or .env files.
Deployment Options: Compatible with Docker deployment for production use.
Development Tools: Provides utilities for local development and testing with features like hot reload.
Agent Integration: Exposes the get_workitem_description tool that agents can discover and use without needing to handle authentication details.
Supports containerized deployment with various methods for environment variable injection, allowing secure configuration of credentials for production environments.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@MCP Workitem Server get description for workitem YEPPPP-154"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
本项目推荐使用 uv 进行依赖管理和运行。
pip install uv # 或参考 uv 官方文档uv pip install -r requirements.txtRelated MCP server: Alibaba Cloud RDS OpenAPI MCP Server
推荐使用 .env 文件或环境变量注入敏感信息。
必需：
organizationId：阿里云组织ID
x-yunxiao-token：阿里云API Token
fastmcp 和 uv 支持自动加载项目根目录下的 .env 文件，无需额外代码。
启动服务时（如 uv run mcp run mcp_server.py），会自动读取 .env 文件中的变量。
你也可以用 python-dotenv 手动加载（如有特殊需求）。
在项目根目录下新建 .env 文件，内容如下：
organizationId=your_org_id
x-yunxiao-token=your_token.env 文件用于本地开发和测试，请勿提交敏感信息到代码仓库。
建议在 .gitignore 文件中加入 .env，防止泄漏：
# .gitignore
.envdocker build -t yx-mcp .通过 --env-file 挂载 .env 文件
在项目根目录准备好 .env 文件（内容同上）
启动容器：
docker run --env-file .env -p 9000:9000 yx-mcp通过 -e 传递环境变量
直接在命令行传递敏感信息：
docker run -e organizationId=your_org_id -e x-yunxiao-token=your_token -p 9000:9000 yx-mcp通过 volume 挂载 .env 文件
将本地 .env 文件挂载到容器内：
docker run -v $(pwd)/.env:/app/.env -p 9000:9000 yx-mcp安全提示： 不要将
.env文件 COPY 进镜像，避免敏感信息泄漏。推荐用--env-file或-e方式传递。
# 方式一：直接用环境变量
export organizationId=your_org_id
export x-yunxiao-token=your_token
uv run mcp run mcp_server.py
# 方式二：自动加载 .env 文件（推荐）
uv run mcp run mcp_server.py本服务通过 MCP 协议暴露 get_workitem_description 工具，参数为需求ID（如 YEPPPP-154），返回结构化 JSON，包含：
text：纯文本描述
images：图片 URL 列表
html：原始 HTML 内容
{
"id": "YEPPPP-154",
"text": "需求描述文本...",
"images": ["https://...jpg"],
"html": "<div>...</div>"
}若外部 API 请求失败，返回 { "error": "错误信息" }，agent 可据此判断。
通过 MCP 协议自动发现和调用 get_workitem_description 工具。
仅需传入 id 参数，无需关心 org_id/token。
推荐用 uv run fastmcp dev mcp_server.py 进行本地开发，支持热重载和交互测试。
支持标准 MCP agent 生态。
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
An MCP Server that provides identity verification and anti-fraud tools for AI agents via deepidv.
MCP server for ByteDance Seedream AI image generation
MCP Server for agents to onboard, pay, and provision services autonomously with InFlow
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/tingxifa/mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server
