MCP server to expose some tools for LLMs
Project description
SWAPNIL MCP Server 🚀
📋 Overview
SWAPNIL MCP Server is a robust implementation of the Model Context Protocol that provides seamless integration with Microsoft Outlook Calendar. It enables AI models to create and schedule meetings through a standardized interface.
🛠️ Setup & Installation
Requirements
- Python 3.9 or higher
- Microsoft Outlook (installed on the system)
- Internet connection (proxy support available)
Quick Start
# Install the package
pip install swapnil-mcp-server
# Start the server
python -m mcp_tools
🧰 Available MCP Tools
This server exposes a powerful tool through the Model Context Protocol interface:
📅 Outlook Calendar
Set_Meeting - Create and schedule a meeting in Microsoft Outlook
async def Set_Meeting(subject: str, start_date: str, end_date: str) -> str
Parameters:
subject: Meeting subjectstart_date: Start date and time in ISO format (e.g., "2023-10-01T10:00:00")end_date: End date and time in ISO format (e.g., "2023-10-01T11:00:00")
Returns:
- A confirmation message with meeting details
Example:
# Schedule a team meeting
result = await Set_Meeting(
"Team Weekly Sync",
"2023-10-01T10:00:00",
"2023-10-01T11:00:00"
)
print(result) # Meeting with subject 'Team Weekly Sync' set from 2023-10-01T10:00:00 to 2023-10-01T11:00:00.
📋 Detailed Usage Guide
Configuration
No specific environment variables are required to run the server. However, Microsoft Outlook must be installed and configured on the system.
Running the Server
Start the server with the following command:
python -m mcp_tools
Integration with MCP Clients
Connect using any MCP-compatible client. Here's a simple Python example:
from mcp.client import Client
async def main():
# Connect to the SWAPNIL MCP Server
client = await Client.connect("http://localhost:8000")
# Schedule a meeting
meeting_result = await client.Set_Meeting(
"Team Retrospective",
"2023-10-15T14:00:00",
"2023-10-15T15:00:00"
)
print(meeting_result)
🔍 Troubleshooting
Common issues and solutions:
- Connection errors: Ensure the server is running and accessible
- Outlook integration issues: Verify Outlook is installed and properly configured
- Proxy issues: Check your network settings and proxy configuration
🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
⚖️ License
This project is licensed under the MIT License - see the LICENSE file for details.
Built with ❤️ for enhancing AI-powered communication
MCP Specification • Microsoft Outlook • FastAPI
Author: Swapnil Dagade
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file swapnil_mcp_server-6.0.1.tar.gz.
File metadata
- Download URL: swapnil_mcp_server-6.0.1.tar.gz
- Upload date:
- Size: 5.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
eb0b47f99c5908c775d841eb7a25215ff2ec55d384c13169c3b5d6d27c746649
|
|
| MD5 |
aa07163ee3cf742b397331e88d24bed0
|
|
| BLAKE2b-256 |
2e954c02448b82ad02417e834ebd5192eefd51c62ce6d334ffe76d0a9f432c9d
|
File details
Details for the file swapnil_mcp_server-6.0.1-py3-none-any.whl.
File metadata
- Download URL: swapnil_mcp_server-6.0.1-py3-none-any.whl
- Upload date:
- Size: 6.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
525dc5919390a55316d7f396c14c26b739f5b4f7e24d23746d00cc20ceb6fe0a
|
|
| MD5 |
1319f4ba2f704c8a602041296f28b8e4
|
|
| BLAKE2b-256 |
fa0f69d9e6b1d284a4aaeac249860459bbe42797e77fe3f0a6f2925d468d432b
|