Movatterモバイル変換

[0]ホーム
URL:

Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

 Sign up
Appearance settings

Commitaddd5e2

Browse files
authored
Update README.md (#13)
1 parent44ef963 commitaddd5e2

File tree

1 file changed

+46
-69
lines changed

1 file changed

+46
-69
lines changed

‎README.md

Lines changed: 46 additions & 69 deletions
Original file line numberDiff line numberDiff line change
@@ -1,84 +1,62 @@
11
#Excel MCP Server
22

3-
A Model Context Protocol (MCP) server implementation that provides Excel file manipulation capabilities without requiring Microsoft Excel installation. This server enables workbook creation, data manipulation, formatting, and advanced Excel features.
4-
5-
##Requirements
6-
7-
- Python 3.10+
8-
- MCP SDK 1.2.0+
9-
- OpenPyXL 3.1.2+
10-
11-
##Components
12-
13-
###Resources
14-
15-
The server provides Excel workbook manipulation through OpenPyXL:
16-
17-
- Creates and modifies Excel workbooks
18-
- Manages worksheets and ranges
19-
- Handles formatting and styles
20-
- Supports charts and pivot tables
21-
22-
###Tools
23-
24-
This server provides a comprehensive set of Excel manipulation tools. For detailed documentation of all available tools, their parameters, and usage examples, please refer to[TOOLS.md](TOOLS.md).
25-
26-
The tools include capabilities for:
27-
28-
- Workbook and worksheet management
29-
- Data reading and writing
30-
- Formatting and styling
31-
- Charts and visualizations
32-
- Pivot tables and data analysis
33-
34-
See[TOOLS.md](TOOLS.md) for complete documentation.
3+
A Model Context Protocol (MCP) server that lets you manipulate Excel files without needing Microsoft Excel installed. Create, read, and modify Excel workbooks with your AI agent.
354

365
##Features
376

38-
-Full Excel Support: Comprehensive Excelfunctionality
39-
-Data Manipulation:Read, write,andtransform data
40-
-Advanced Features: Charts, pivot tables,andformatting
41-
-Error Handling: Comprehensive error handling with clear messages
42-
43-
##Usage
7+
-📊 Create and modify Excelworkbooks
8+
-📝Readandwrite data
9+
-🎨 Apply formattingandstyles
10+
-📈 Create charts and visualizations
11+
- 📊 Generate pivot tables
12+
- 🔄 Manage worksheets and ranges
4413

45-
###Environment Configuration
14+
##Quick Start
4615

47-
The server can be configured using the following environment variables:
16+
###Prerequisites
4817

49-
-`EXCEL_FILES_PATH`: Directory where Excel files will be stored (default:`./excel_files`)
18+
-Python 3.10 or higher
5019

51-
You can set this in different ways:
20+
###Installation
5221

53-
Windows CMD:
22+
1. Clone the repository:
23+
```bash
24+
git clone https://github.com/haris-musa/excel-mcp-server.git
25+
cd excel-mcp-server
26+
```
5427

55-
```cmd
56-
set EXCEL_FILES_PATH=C:\path\to\excel\files
57-
uvrun excel-mcp-server
28+
2. Install using uv:
29+
```bash
30+
uvpip install -e.
5831
```
5932

60-
Windows PowerShell:
33+
###Running the Server
6134

62-
```powershell
63-
$env:EXCEL_FILES_PATH="C:\path\to\excel\files"
35+
Start the server (default port 8000):
36+
```bash
6437
uv run excel-mcp-server
6538
```
6639

67-
Linux/MacOS:
40+
Custom port (e.g., 8080):
6841

6942
```bash
70-
export EXCEL_FILES_PATH=/path/to/excel/files
71-
uv run excel-mcp-server
43+
# Bash/Linux/macOS
44+
export FASTMCP_PORT=8080&& uv run excel-mcp-server
45+
46+
# Windows PowerShell
47+
$env:FASTMCP_PORT ="8080"; uv run excel-mcp-server
7248
```
7349

74-
Or in Claude Desktop config:
50+
##Using with AI Tools
7551

52+
###Cursor IDE
53+
54+
1. Add this configuration to Cursor:
7655
```json
7756
{
7857
"mcpServers": {
7958
"excel": {
80-
"command":"uv run excel-mcp-server",
81-
"transport":"sse",
59+
"url":"http://localhost:8000/sse",
8260
"env": {
8361
"EXCEL_FILES_PATH":"/path/to/excel/files"
8462
}
@@ -87,28 +65,27 @@ Or in Claude Desktop config:
8765
}
8866
```
8967

90-
###Starting the Server
68+
2. The Excel tools will be available through your AI assistant.
9169

92-
Start the server:
70+
###Remote Hosting & Transport Protocols
9371

94-
```bash
95-
uv run excel-mcp-server
96-
```
72+
This server uses Server-Sent Events (SSE) transport protocol. For different use cases:
9773

98-
The server will start in SSE mode and wait for connections from MCP clients.
74+
1.**Using with Claude Desktop (requires stdio):**
75+
- Use[Supergateway](https://github.com/supercorp-ai/supergateway) to convert SSE to stdio:
9976

100-
###Connecting in Cursor IDE
77+
2.**Hosting Your MCP Server:**
78+
-[Remote MCP Server Guide](https://developers.cloudflare.com/agents/guides/remote-mcp-server/)
10179

102-
After starting the server, connect to the SSE endpoint in Cursor IDE:
80+
##Environment Variables
10381

104-
```
105-
http://localhost:8000/sse
106-
```
82+
-`FASTMCP_PORT`: Server port (default: 8000)
83+
-`EXCEL_FILES_PATH`: Directory for Excel files (default:`./excel_files`)
10784

108-
The Excel MCP tools will be available through the agent.
85+
##Available Tools
10986

110-
For available tools and their usage, please refer to[TOOLS.md](TOOLS.md).
87+
The server provides a comprehensive set of Excel manipulation tools. See[TOOLS.md](TOOLS.md) for complete documentation of all available tools.
11188

11289
##License
11390

114-
This project is licensed under theMIT License - seethe[LICENSE](LICENSE) file for details.
91+
MIT License - see[LICENSE](LICENSE) for details.

0 commit comments

Comments
 (0)
[8]ページ先頭
©2009-2025 Movatter.jp