Provides tools for interacting with Azure DevOps wikis, including searching content, reading and updating wiki pages, navigating hierarchical page structures, and listing and managing wikis within Azure DevOps projects.
🌟 Azure DevOps Wiki MCP Server
A Model Context Protocol (MCP) server that brings Azure DevOps Wiki context to your AI agents, enabling seamless integration with Azure DevOps wikis.
📄 Table of Contents
- 🌟 Project Overview
- ⚙️ Supported Tools
- 🔌 Installation & Getting Started
- 🔑 Authentication
- 🛠️ Development
- 🏗️ Architecture
- 🤝 Contributing
- 📝 License
🌟 Project Overview
The Azure DevOps Wiki MCP Server enables AI applications to interact with Azure DevOps wikis through the Model Context Protocol. It provides comprehensive wiki operations including content search, page management, and hierarchical structure navigation.
Key Features:
- 🔍 Search across wiki content
- 📄 Read and update wiki pages
- 🌲 Navigate hierarchical page structures
- 📋 List and manage wikis
- 🔐 Secure authentication via Azure CLI or PAT
⚙️ Supported Tools
🔍 search_wiki
Search across wiki content using Azure DevOps Search API.
Parameters:
organization
(required): Azure DevOps organization nameproject
(required): Project namesearchText
(required): Search query stringwikiId
(optional): Specific wiki identifier
🌲 wiki_get_page_tree
Retrieve hierarchical page structure from wiki.
Parameters:
organization
(required): Azure DevOps organization nameproject
(required): Project namewikiId
(required): Wiki identifierdepth
(optional): Maximum depth to retrieve
📄 wiki_get_page
Get content of a specific wiki page.
Parameters:
organization
(required): Azure DevOps organization nameproject
(required): Project namewikiId
(required): Wiki identifierpath
(required): Page path or page ID
✏️ wiki_update_page
Update content of an existing wiki page or create a new page if it does not exist.
Parameters:
organization
(required): Azure DevOps organization nameproject
(required): Project namewikiId
(required): Wiki identifierpath
(required): Page path or page IDcontent
(required): New page content (Markdown)
📋 list_wiki
List all wikis in a project.
Parameters:
organization
(optional): Azure DevOps organization nameproject
(optional): Project name
Note: Both parameters are optional and will use environment defaults if not provided.
🔌 Installation & Getting Started
Prerequisites
- Node.js 18 or higher
- Azure CLI installed and configured (
az login
) Required only if you wish to authenticate with Azure, not required if you choose to use PAT token - Appropriate Azure DevOps permissions for target organization
Configure in Claude Desktop using PAT authentication
Add to your claude_desktop_config.json
:
Configure in Claude Desktop using Azure authentication
- Authenticate with Azure:
- Configure with Claude Desktop:
Add to your
claude_desktop_config.json
:
🔑 Authentication
This server supports two authentication methods:
1. Azure CLI Authentication (Default)
Make sure you're logged in:
The server will use your Azure CLI credentials to authenticate with Azure DevOps.
2. Personal Access Token (PAT)
You can also use a Personal Access Token for authentication by setting environment variable AZURE_DEVOPS_PAT
.
Creating a PAT:
- Go to Azure DevOps → User Settings → Personal Access Tokens
- Create a new token with the following scopes:
- Wiki: Read & Write
- Project and Team: Read (for project access)
- Copy the token and set it in the
AZURE_DEVOPS_PAT
environment variable
Environment Variables:
Environment Variables | Description | Required? |
---|---|---|
AZURE_DEVOPS_URL | Azure DevOps URL | Yes |
AZURE_DEVOPS_PROJECT | Default project name (optional) | No |
AZURE_DEVOPS_PAT | No | |
AZURE_DEVOPS_ORGANIZATION | Azure DevOps Organization Name | Yes |
When using PAT authentication, the server will prioritize the PAT over Azure CLI credentials.
🛠️ Development
Setup
Available Commands
For Local Development
Add to your claude_desktop_config.json
:
Debug in IDE
- Start up @modelcontextprotocol/inspector with inspection turned on:
- Use IDE (vscode / cursor), select "Attach to MCP Server" and start debug
- Enter local test data from MCP Inspector UI
🏗️ Architecture
The server follows the Model Context Protocol specification and integrates with Azure DevOps Wiki API through the official azure-devops-node-api
client library.
Key Components:
- MCP Server: Implements MCP protocol using
@modelcontextprotocol/sdk
- Azure DevOps Client: Wrapper around
azure-devops-node-api
for Wiki API operations - Tool Handlers: Five main tools implementing MCP tool interface
- Authentication: Azure CLI-based authentication with PAT fallback
📦 Package Publishing & Release Management
Version Bumping
The project includes automated version bumping scripts for semantic versioning:
Each version bump command automatically:
- Updates the version in
package.json
- Creates a git commit with the version number
- Creates a git tag (e.g.,
v1.0.1
)
🤝 Contributing
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests
- Submit a pull request
📝 License
MIT
A Model Context Protocol server that enables AI agents to interact with Azure DevOps wikis, providing capabilities for content search, page management, and hierarchical structure navigation.
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol server that enables AI assistants to interact with Azure DevOps resources including projects, work items, repositories, pull requests, branches, and pipelines through a standardized protocol.Last updated -15622279TypeScriptMIT License
- -securityFlicense-qualityA reference server implementation for the Model Context Protocol that enables AI assistants to interact with Azure DevOps resources and perform operations such as project management, work item tracking, repository operations, and code search programmatically.Last updated -7TypeScript
- AsecurityAlicenseAqualityA Model Context Protocol server that enables AI assistants to interact with Azure DevOps services, allowing users to query work items with plans to support creating/updating items, managing pipelines, handling pull requests, and administering sprints and branch policies.Last updated -971PythonMIT License
- AsecurityAlicenseAqualityA Model Context Protocol server that allows AI assistants and applications to access IQ.wiki data, enabling retrieval of specific wikis, user-created wikis, user-edited wikis, and detailed wiki activities.Last updated -44061TypeScriptMIT License