Content
# MCP Go Gemini Server
🚀 Một MCP (Model Context Protocol) server được xây dựng bằng Go, tích hợp với Google Gemini API để cung cấp các tính năng AI tiên tiến.
[](https://golang.org/)
[](LICENSE)
[](https://modelcontextprotocol.io/)
## ✨ Tính năng
- **🤖 Text Generation**: Tạo văn bản thông minh với Gemini
- **🔍 Code Analysis**: Phân tích, giải thích và review mã nguồn
- **✍️ Text Improvement**: Cải thiện văn bản và nâng cao chất lượng
- **🌐 Translation**: Dịch thuật đa ngôn ngữ chính xác
- **❓ Question Answering**: Trả lời câu hỏi với độ chính xác cao
- **⚡ Code Generation**: Tạo mã nguồn từ mô tả tự nhiên
- **📄 Document Summarization**: Tóm tắt tài liệu thông minh
## 🚀 Cài đặt nhanh
### Yêu cầu hệ thống
- Go 1.21 trở lên
- API key của Gemini (miễn phí tại [Google AI Studio](https://aistudio.google.com/app/apikey))
### Cài đặt
```bash
# Clone repository
git clone <repository-url>
cd mcp-go-gemini
# Cài đặt dependencies
go mod tidy
# Thiết lập API key
export GEMINI_API_KEY="your-api-key-here"
# Build và chạy
go build -o mcp-go-gemini .
./mcp-go-gemini
```
Hoặc sử dụng script nhanh:
```bash
./start.sh
```
## 🛠 Sử dụng với MCP Clients
### Claude Desktop
Thêm cấu hình vào `claude_desktop_config.json`:
```json
{
"mcpServers": {
"mcp-go-gemini": {
"command": "/path/to/mcp-go-gemini",
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}
```
### VS Code + Cline Extension
1. Cài đặt Cline extension
2. Cấu hình MCP server trong settings
3. Sử dụng trực tiếp trong VS Code
## 📚 API Documentation
### Các công cụ có sẵn
| Công cụ | Mô tả | Tham số |
|---------|-------|---------|
| `generate_text` | Tạo văn bản | `prompt`, `temperature`, `max_tokens` |
| `analyze_code` | Phân tích mã nguồn | `code`, `language`, `task` |
| `improve_text` | Cải thiện văn bản | `text`, `task` |
| `translate_text` | Dịch thuật | `text`, `source_language`, `target_language` |
| `answer_question` | Trả lời câu hỏi | `question`, `context` |
| `generate_code` | Tạo mã nguồn | `description`, `language`, `framework` |
| `summarize_document` | Tóm tắt tài liệu | `content`, `length` |
### Ví dụ sử dụng
#### Tạo văn bản
```json
{
"name": "generate_text",
"arguments": {
"prompt": "Viết một bài thơ về ngôn ngữ lập trình Go",
"temperature": 0.8
}
}
```
#### Phân tích mã nguồn
```json
{
"name": "analyze_code",
"arguments": {
"code": "func main() { fmt.Println(\"Hello, World!\") }",
"language": "go",
"task": "explain"
}
}
```
#### Dịch thuật
```json
{
"name": "translate_text",
"arguments": {
"text": "Hello, world!",
"source_language": "English",
"target_language": "Vietnamese"
}
}
```
Xem thêm tại [API Reference](API_REFERENCE.md)
## 📁 Cấu trúc dự án
```
mcp-go-gemini/
├── main.go # Entry point
├── internal/
│ ├── gemini/ # Gemini API integration
│ │ └── client.go
│ ├── handlers/ # Tool handlers
│ │ └── handlers.go
│ └── config/ # Configuration
│ └── config.go
├── examples/ # Usage examples
├── docs/ # Documentation
├── Dockerfile # Docker configuration
├── docker-compose.yml # Docker Compose
├── Makefile # Build automation
└── README.md
```
## 🧪 Testing
Chạy test để kiểm tra functionality:
```bash
# Unit tests
go test ./...
# Integration test với API thật
go run test_client.go
# Build test
make test
```
## 🐳 Docker Support
```bash
# Build image
docker build -t mcp-go-gemini .
# Run với docker-compose
docker-compose up -d
```
## 🔧 Development
### Build commands
```bash
make build # Build binary
make run # Build và chạy
make clean # Clean artifacts
make test # Run tests
make lint # Code linting
```
### Code structure
- `internal/gemini/`: Gemini API client và wrapper
- `internal/handlers/`: MCP tool handlers
- `internal/config/`: Configuration management
- `main.go`: Server initialization và tool registration
## 🚦 Performance
- **Response time**: ~1-3 giây cho most operations
- **Concurrency**: Thread-safe, hỗ trợ multiple clients
- **Memory**: ~10-50MB runtime usage
- **Rate limiting**: Tuân thủ Gemini API limits
## 🔐 Security
- ✅ API key qua environment variables
- ✅ Input validation và sanitization
- ✅ Error handling secure
- ✅ No sensitive data logging
- ✅ HTTPS cho tất cả API calls
## 📋 Troubleshooting
### Lỗi thường gặp
1. **"GEMINI_API_KEY not set"**
- Đảm bảo đã set environment variable
- Kiểm tra API key hợp lệ
2. **"Failed to create client"**
- Kiểm tra internet connection
- Verify API key tại Google AI Studio
3. **Build errors**
- Đảm bảo Go 1.21+
- Chạy `go mod tidy`
Xem thêm tại [Installation Guide](INSTALLATION.md)
## 🤝 Contributing
1. Fork the project
2. Create feature branch (`git checkout -b feature/amazing-feature`)
3. Commit changes (`git commit -m 'Add amazing feature'`)
4. Push to branch (`git push origin feature/amazing-feature`)
5. Open Pull Request
## 📄 License
Distributed under the MIT License. See `LICENSE` for more information.
## 🙏 Acknowledgments
- [Google Gemini API](https://ai.google.dev/) - Powerful AI capabilities
- [MCP Go](https://github.com/mark3labs/mcp-go) - Excellent MCP implementation
- [Model Context Protocol](https://modelcontextprotocol.io/) - Open standard
## 📞 Support
- 📧 Email: [your-email]
- 🐛 Issues: [GitHub Issues]
- 💬 Discussions: [GitHub Discussions]
- 📖 Docs: [Full Documentation]
---
**Made with ❤️ and Go** • **Powered by Gemini AI** • **MCP Compatible**
MCP Store