Ms Style Guide Fastmcp Server
No description available
Ask AI about Ms Style Guide Fastmcp Server
Powered by Claude Β· Grounded in docs
I know everything about Ms Style Guide Fastmcp Server. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
Microsoft Style Guide FastMCP Server
A streamlined, cross-platform MCP server for analyzing content against the Microsoft Writing Style Guide using the FastMCP framework. Choose between Offline and Web-Enabled versions based on your needs.
π Quick Start (One Command)
# Clone or download this repository
git clone https://github.com/asudbring/ms-style-guide-fastmcp-server.git
cd ms-style-guide-fastmcp-server
# Interactive setup (choose your version)
python fastmcp_setup.py
# OR Auto setup with specific version
python fastmcp_setup.py --offline # Fast, reliable, works offline
python fastmcp_setup.py --web # Live content from Microsoft Learn
That's it! The setup script will:
- β Let you choose between Offline or Web-Enabled versions
- β Install FastMCP and version-specific dependencies
- β
Configure VS Code global
mcp.json - β Set up Copilot Chat integration
- β Create test files and documentation
- β Test server functionality
π― Choose Your Version
π Version Comparison
| Feature | Offline Version | Web-Enabled Version |
|---|---|---|
| Setup | Fastest, minimal dependencies | Quick, requires aiohttp |
| Speed | β‘ Very fast (local analysis) | π Fast (with web requests) |
| Internet | β Not required | β Required for full features |
| Content | Local patterns + official links | Live content from Microsoft Learn |
| Accuracy | High (local patterns) | Highest (official guidance) |
| Reliability | Very high (offline) | High (depends on internet) |
| Up-to-date | Static rules | Always current |
| Use Case | Fast checking, offline work | Detailed guidance, online work |
π€ Which Version Should I Choose?
Choose Offline Version if:
- β You want the fastest possible analysis
- β You work in environments without reliable internet
- β You need consistent performance
- β You primarily need pattern-based checking
- β Security policies restrict web access
Choose Web-Enabled Version if:
- β You want the most accurate, up-to-date guidance
- β You have reliable internet connection
- β You need official examples and live content
- β You want real-time search capabilities
- β You're creating content that needs official validation
π Project Structure
ms-style-guide-fastmcp-server/
βββ fastmcp_style_server.py # Offline FastMCP server
βββ fastmcp_style_server_web.py # Web-enabled FastMCP server
βββ fastmcp_setup.py # Intelligent setup script
βββ mcp.json # VS Code MCP configuration
βββ copilot_usage.md # Usage examples and documentation
βββ requirements.txt # Python dependencies
βββ readme.md # This file
π― Microsoft Style Guide Analysis
Both versions analyze content based on Microsoft's core principles:
Voice and Tone
- Warm and Relaxed: Use contractions, natural language
- Crisp and Clear: Direct, scannable content
- Ready to Help: Action-oriented, supportive language
Analysis Types
comprehensive- Complete style analysis (default)voice_tone- Voice and tone compliancegrammar- Grammar and style patternsterminology- Microsoft terminology standardsaccessibility- Inclusive language checking
Version-Specific Features
Offline Version Features
- β‘ Lightning Fast: Instant local analysis
- πΎ No Dependencies: Works completely offline
- π Secure: No external web requests
- π Pattern-Based: Comprehensive regex pattern matching
- π Official Links: Direct links to Microsoft Style Guide
Web-Enabled Version Features
- π Live Content: Fetches real content from Microsoft Learn
- π Current Examples: Always up-to-date official examples
- π Live Search: Real-time search of Microsoft Style Guide
- π Official Guidance: Fetches specific guidance for detected issues
- β‘ Smart Caching: Caches web content for performance
π¬ GitHub Copilot Chat Integration
Version-Aware Commands
Both versions support the same natural language commands, but provide different levels of detail:
Basic Commands (Both Versions)
analyze this content for Microsoft Style Guide compliance:
"Welcome to our new product! You can easily configure the settings."
check voice and tone of this text:
"Users can configure settings through the interface."
suggest improvements for this writing:
"Users should use the functionality to optimize performance."
show Microsoft Style Guide guidelines for accessibility
Web-Enhanced Commands (Web Version Only)
search the Microsoft Style Guide for "active voice examples"
get live guidance on "inclusive language best practices"
fetch current Microsoft terminology standards
find official examples for "contractions in technical writing"
Command Responses by Version
Offline Version Response
π Microsoft Style Guide Analysis
β
Good - Minor improvements suggested
π Text Statistics:
β’ Words: 32 | Sentences: 2 | Avg: 16.0 words/sentence
π Issues Found: 2
β’ Voice/Tone: Use more contractions for natural tone
β’ Terminology: Use "sign in" instead of "login"
π Official Guidelines: https://learn.microsoft.com/en-us/style-guide
πΎ Offline Analysis: Fast local pattern matching
Web Version Response
π Microsoft Style Guide Analysis (Web-Enabled)
β
Good - Minor improvements suggested
π Text Statistics:
β’ Words: 32 | Sentences: 2 | Avg: 16.0 words/sentence
π Issues Found: 2
β’ Voice/Tone: Use more contractions for natural tone
β’ Terminology: Use "sign in" instead of "login"
π Live Official Guidance Retrieved:
β’ Voice/Tone: Microsoft's brand voice: above all, simple and human
https://learn.microsoft.com/en-us/style-guide/brand-voice-above-all-simple-human
β’ Terminology: A-Z word list and term collections
https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections
β‘ Web-Enabled: Live guidance from Microsoft Learn
π οΈ Available MCP Tools
Offline Version Tools
| Tool | Description | Speed | Accuracy |
|---|---|---|---|
analyze_content | Pattern-based style analysis | β‘ Very Fast | β High |
get_style_guidelines | Local guidelines with official links | β‘ Instant | β High |
suggest_improvements | Local improvement suggestions | β‘ Very Fast | β High |
search_style_guide | Links to official documentation | β‘ Instant | β High |
Web-Enabled Version Tools
| Tool | Description | Speed | Accuracy |
|---|---|---|---|
analyze_content | Pattern + live guidance analysis | π Fast | π― Excellent |
get_style_guidelines | Live guidelines from Microsoft Learn | π Fast | π― Excellent |
suggest_improvements | Live guidance + local suggestions | π Fast | π― Excellent |
search_style_guide | Live search of Microsoft documentation | π Fast | π― Excellent |
get_official_guidance | Fetch specific official guidance | π Fast | π― Excellent |
π§ Setup Options
Interactive Setup (Recommended)
python fastmcp_setup.py
# Choose your version during setup
# Get explanations of each version's benefits
Command Line Setup
# Force specific versions
python fastmcp_setup.py --offline # Fast, reliable offline version
python fastmcp_setup.py --web # Live content web version
python fastmcp_setup.py --auto # Auto-select offline version
# Special options
python fastmcp_setup.py --copilot # Focus on Copilot Chat integration
Manual Configuration (If Needed)
For Offline Version
Create %APPDATA%\Code\User\mcp.json (Windows) or equivalent:
{
"servers": {
"microsoft-style-guide": {
"command": "python",
"args": ["path/to/fastmcp_style_server.py"],
"env": {"PYTHONPATH": "path/to/project"},
"initializationOptions": {
"name": "Microsoft Style Guide (Offline)",
"server_type": "fastmcp_offline"
}
}
}
}
For Web-Enabled Version
{
"servers": {
"microsoft-style-guide": {
"command": "python",
"args": ["path/to/fastmcp_style_server_web.py"],
"env": {"PYTHONPATH": "path/to/project"},
"initializationOptions": {
"name": "Microsoft Style Guide (Web)",
"server_type": "fastmcp_web",
"capabilities": {"web_enabled": true}
}
}
}
}
π§ͺ Testing Your Setup
1. Test the Server
# Test offline version
python fastmcp_style_server.py --test
# Test web version
python fastmcp_style_server_web.py --test
2. Test in VS Code
- Open a markdown file for testing
- Use Copilot Chat:
@workspace analyze this document - Check that MCP tools appear in Command Palette
- Verify correct version is running in MCP server list
π Performance Comparison
Speed Benchmarks
| Operation | Offline Version | Web Version |
|---|---|---|
| Server Startup | ~0.5 seconds | ~1.0 seconds |
| Simple Analysis | ~0.1 seconds | ~0.3 seconds |
| Complex Analysis | ~0.2 seconds | ~0.8 seconds |
| Guidelines Retrieval | ~0.05 seconds | ~0.5 seconds |
| Search Operations | ~0.05 seconds | ~1.0 seconds |
Resource Usage
| Resource | Offline Version | Web Version |
|---|---|---|
| Memory | ~20MB | ~35MB |
| CPU | Very Low | Low |
| Network | None | Moderate |
| Storage | ~2MB | ~2MB + cache |
π― Use Case Recommendations
Choose Offline Version For:
Content Development
- β Draft writing and quick style checks
- β Code comment analysis
- β README file improvements
- β Batch processing multiple files
Environments
- β Secure/air-gapped environments
- β Unreliable internet connections
- β Performance-critical workflows
- β CI/CD pipelines
Teams
- β Large teams needing consistent performance
- β Junior developers learning style guidelines
- β Automated quality checks
Choose Web Version For:
Content Publishing
- β Final review before publication
- β Marketing copy validation
- β Official documentation
- β Customer-facing content
Environments
- β Stable internet connections
- β Content teams needing latest guidance
- β Editorial workflows
- β Style guide research
Teams
- β Content creators and technical writers
- β Marketing teams
- β Documentation teams
- β Style guide maintainers
π Troubleshooting
Server Not Appearing in VS Code
- Check that
mcp.jsonexists in VS Code User directory - Restart VS Code completely (close all windows)
- Verify MCP extension is installed and enabled
- Check VS Code Developer Console for MCP errors
Python Path Issues
# Check Python executable
which python
python --version
# Update mcp.json with absolute paths if needed
Dependencies Missing
# Reinstall dependencies
pip install fastmcp
# OR
pip install mcp
# Test server directly
python fastmcp_style_server.py --test
Copilot Chat Isn't Working
- Ensure GitHub Copilot Chat extension is installed
- Verify MCP server is running and accessible
- Check VS Code Developer Console for MCP errors
Advanced Usage
Custom Analysis Types
# In your own scripts
from fastmcp_style_server import analyzer
result = analyzer.analyze_content("Your text", "voice_tone")
guidelines = analyzer.get_style_guidelines("accessibility")
Batch Processing
# Analyze multiple files using the server directly
from fastmcp_style_server import analyzer
for file in ["README.md", "docs/guide.md"]:
with open(file, 'r') as f:
content = f.read()
result = analyzer.analyze_content(content)
print(f"{file}: {result}")
CI/CD Integration
# GitHub Actions example
- name: Check Style Guide Compliance
run: |
python fastmcp_style_server.py --test
# Add your analysis workflow here
π€ Contributing
- Fork this repository
- Make changes to FastMCP server or setup
- Test with
python fastmcp_setup.py --auto - Submit pull request
π References
π License
MIT License - see LICENSE file for details.
Built with FastMCP for better technical writing β¨
